This is an automated email from the ASF dual-hosted git repository.
asf-gitbox-commits pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/struts-site.git
The following commit(s) were added to refs/heads/asf-site by this push:
new c15169d8f9 Automatic Site Publish by Buildbot
c15169d8f9 is described below
commit c15169d8f9c14ec0ff1c98cbf6e9c86375e865a0
Author: buildbot <[email protected]>
AuthorDate: Sat Oct 24 14:27:26 2026 +0000
Automatic Site Publish by Buildbot
---
output/tag-developers/datetextfield-tag.html | 14 ++++++++++++--
1 file changed, 12 insertions(+), 2 deletions(-)
diff --git a/output/tag-developers/datetextfield-tag.html
b/output/tag-developers/datetextfield-tag.html
index aa0e2e99d3..9dcdc36e7b 100644
--- a/output/tag-developers/datetextfield-tag.html
+++ b/output/tag-developers/datetextfield-tag.html
@@ -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"><s:textfield
type="datetime-local"/></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"><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">/></span>
+<span class="nt"><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">/></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>
