(struts-site) branch asf-staging updated: Updates stage by Jenkins

[git-site-role]

This is an automated email from the ASF dual-hosted git repository.

asf-gitbox-commits pushed a commit to branch asf-staging
in repository https://gitbox.apache.org/repos/asf/struts-site.git


The following commit(s) were added to refs/heads/asf-staging by this push:
     new 8ccbc2dfc7 Updates stage by Jenkins
8ccbc2dfc7 is described below

commit 8ccbc2dfc73e929dad5ec5d8d043cad687a75395
Author: jenkins <bui...@apache.org>
AuthorDate: Sat Oct 24 14:00:01 2026 +0000

    Updates stage by Jenkins
---
 content/tag-developers/datetextfield-tag.html | 20 +++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/content/tag-developers/datetextfield-tag.html 
b/content/tag-developers/datetextfield-tag.html
index ef329bff61..9dcdc36e7b 100644
--- a/content/tag-developers/datetextfield-tag.html
+++ b/content/tag-developers/datetextfield-tag.html
@@ -158,7 +158,7 @@
 
 <h2 id="description">Description</h2>
 
-<p>Render an HTML input fields with the date time</p>
+<p>Render an HTML input for a date: a native input type=”date” in the html5 
theme, split input fields with the JavaTemplates plugin</p>
 
 <h2 id="attributes">Attributes</h2>
 
@@ -235,11 +235,11 @@
     </tr>
     <tr>
         <td class="tag-attribute">format</td>
-        <td class="tag-attribute"><strong>true</strong></td>
+        <td class="tag-attribute">false</td>
         <td class="tag-attribute"></td>
         <td class="tag-attribute">false</td>
         <td class="tag-attribute">String</td>
-        <td class="tag-attribute">Date format attribute</td>
+        <td class="tag-attribute">Date format used to lay out the split input 
fields of the JavaTemplates plugin; ignored by the html5 theme, which always 
uses yyyy-MM-dd</td>
     </tr>
     <tr>
         <td class="tag-attribute">id</td>
@@ -543,16 +543,26 @@ date in the user’s locale and always submits it as <code 
class="language-plain
 </code></pre></div></div>
 
 <ul>
-  <li>The property must be a <code class="language-plaintext 
highlighter-rouge">java.util.Date</code>; its value is rendered in the server’s 
default time zone</li>
+  <li>The property should be a <code class="language-plaintext 
highlighter-rouge">java.util.Date</code> or a <code class="language-plaintext 
highlighter-rouge">java.time.LocalDate</code> (since 7.5.0); a <code 
class="language-plaintext highlighter-rouge">java.util.Date</code> is rendered
+in the server’s default time zone</li>
+  <li>A type with a time part (<code class="language-plaintext 
highlighter-rouge">LocalDateTime</code>, <code class="language-plaintext 
highlighter-rouge">ZonedDateTime</code>, <code class="language-plaintext 
highlighter-rouge">OffsetDateTime</code>) renders its date part, but a date 
input
+cannot submit a time, so binding back into such a property fails — use <code 
class="language-plaintext highlighter-rouge">&lt;s:textfield 
type="datetime-local"/&gt;</code> instead</li>
   <li><code class="language-plaintext highlighter-rouge">min</code> and <code 
class="language-plaintext highlighter-rouge">max</code> are passed through as 
dynamic attributes and must be written as <code class="language-plaintext 
highlighter-rouge">yyyy-MM-dd</code></li>
 </ul>
 
 <p>With the <a href="../plugins/javatemplates/">JavaTemplates Plugin</a> the 
tag renders one text input per date field, laid out
-by the <code class="language-plaintext highlighter-rouge">format</code> 
attribute, and <code class="language-plaintext 
highlighter-rouge">DateTextFieldInterceptor</code> assembles them back into a 
<code class="language-plaintext highlighter-rouge">java.util.Date</code>:</p>
+by the <code class="language-plaintext highlighter-rouge">format</code> 
attribute, and <code class="language-plaintext 
highlighter-rouge">DateTextFieldInterceptor</code> assembles them back into a 
date:</p>
 
 <div class="language-jsp highlighter-rouge"><div class="highlight"><pre 
class="highlight"><code><span class="nt">&lt;s:datetextfield </span><span 
class="na">name=</span><span class="s">"birthday"</span><span class="na"> 
format=</span><span class="s">"dd/MM/yyyy"</span><span class="nt">/&gt;</span>
+<span class="nt">&lt;s:datetextfield </span><span class="na">name=</span><span 
class="s">"meetingAt"</span><span class="na"> format=</span><span 
class="s">"dd/MM/yyyy HH:mm"</span><span class="nt">/&gt;</span>
 </code></pre></div></div>
 
+<ul>
+  <li>The property can be a <code class="language-plaintext 
highlighter-rouge">java.util.Date</code>, <code class="language-plaintext 
highlighter-rouge">java.time.LocalDate</code>, <code class="language-plaintext 
highlighter-rouge">java.time.LocalDateTime</code> or <code 
class="language-plaintext highlighter-rouge">java.time.LocalTime</code>
+(the <code class="language-plaintext highlighter-rouge">java.time</code> types 
since 7.5.0), converted in the server’s default time zone</li>
+  <li>A field in <code class="language-plaintext 
highlighter-rouge">format</code> that the property’s type does not have, such 
as <code class="language-plaintext highlighter-rouge">HH</code> on a <code 
class="language-plaintext highlighter-rouge">LocalDate</code>, renders 
empty</li>
+</ul>
+
 <p>The simple, xhtml and css_xhtml themes do not support this tag.</p>
 
   </section>