Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Support java.time.* in fmt:parseDate and fmt:formatDate #273

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
+20 −18
Open

Support java.time.* in fmt:parseDate and fmt:formatDate #273

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c0660aa
Spec https://github.com/jakartaee/tags/issues/247
BalusC Mar 8, 2025
49475af
Improved #247: fixes after self-review
BalusC Mar 8, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 20 additions & 18 deletions spec/src/main/asciidoc/jakarta-stl.adoc
View file
Original file line number Diff line number Diff line change
@@ -4705,7 +4705,7 @@ locale-sensitive or customized manner.

[literal, subs="+quotes, +attributes"]
<fmt:formatDate value="date"
{blank}[type="{time|[underline]#date#|both}"]
{blank}[type="{time|[underline]#date#|both|localDate|localTime|localDateTime|offsetTime|offsetDateTime|zonedDateTime}"]
{blank}[dateStyle="{[underline]#default#|short|medium|long|full}"]
{blank}[timeStyle="{[underline]#default#|short|medium|long|full}"]
[pattern="customPattern"]
@@ -4726,16 +4726,16 @@ Empty.
|Type |Description
| _value_ | _true_
a|
_java.util._

_Date_
_java.util.Date_, _java.time.temporal.Temporal_

|Date and/or time to be formatted.

|type | _true_
|String |Specifies
whether the time, the date, or both the time and date components of the
given date are to be formatted.
|String |Specifies the type of the given date.
Valid values are "date", "time", "both", "localDate", "localDateTime", "localTime", "offsetTime", "offsetDateTime", and "zonedDateTime".
The values "date", "time", and "both" correspond to java.util.Date and the value specifies whether the time, the date, or both the time and date components of the given date are to be formatted.
The other values correspond to Java SE 8 Date Time API classes in package java.time with the name derived by upper casing the first letter.
For example, java.time.LocalDate for the value "localDate". Default value is "date".

|dateStyle |true
|String
@@ -4757,9 +4757,8 @@ formatting style for dates and times.

|timeZone | _true_
a|
String or java.util.

TimeZone
_String_ or _java.util.TimeZone_.
Applied only when value is a _java.util.Date_; ignored otherwise.

|Time zone in which to represent the
formatted time.
@@ -4847,7 +4846,7 @@ _Syntax 1: without a body_

[literal, subs="+quotes, +attributes"]
<fmt:parseDate value="dateString"
{blank}[type="{time|[underline]#date#|both}"]
{blank}[type="{time|[underline]#date#|both|localDate|localTime|localDateTime|offsetTime|offsetDateTime|zonedDateTime}"]
{blank}[dateStyle="{[underline]#default#|short|medium|long|full}"]
{blank}[timeStyle="{[underline]#default#|short|medium|long|full}"]
[pattern="customPattern"]
@@ -4860,7 +4859,7 @@ _Syntax 2: with a body to specify the date
value to be parsed_

[literal, subs="+quotes, +attributes"]
<fmt:parseDate {blank}[type="{time|[underline]#date#|both}"]
<fmt:parseDate {blank}[type="{time|[underline]#date#|both|localDate|localTime|localDateTime|offsetTime|offsetDateTime|zonedDateTime}"]
{blank}[dateStyle="{[underline]#default#|short|medium|long|full}"]
{blank}[timeStyle="{[underline]#default#|short|medium|long|full}"]
[pattern="customPattern"]
@@ -4888,23 +4887,25 @@ content, then the action trims it and processes it further.
string to be parsed.

|type | _true_
|String |Specifies
whether the date string in the _value_ attribute is supposed to contain
a time, a date, or both.
|String |Specifies what type the string value will be parsed into.
Valid values are "date", "time", "both", "localDate", "localDateTime", "localTime", "offsetTime", "offsetDateTime", and "zonedDateTime".
The values "date", "time", and "both" correspond to java.util.Date and the value specifies whether the date string in the _value_ attribute is supposed to contain a time, a date, or both.
The other values correspond to Java SE 8 Date Time API classes in package java.time with the name derived by upper casing the first letter.
For example, java.time.LocalDate for the value "localDate". Default value is "date".

|dateStyle |true
|String
|Predefined formatting style for days which
determines how the date component of the date string is to be parsed.
Applied only when formatting a date or both a date and time (i.e. if
_type_ is missing or is equal to "date" or "both"); ignored otherwise.
_type_ is missing or is equal to "date", "both", "localDate", "localDateTime", "offsetDateTime", or "zonedDateTime"); ignored otherwise.

|timeStyle |true
|String
|Predefined formatting styles for times which
determines how the time component in the date string is to be parsed.
Applied only when formatting a time or both a date and time (i.e. if
_type_ is equal to "time" or "both"); ignored otherwise.
_type_ is equal to "time", "both", "localTime", "offsetTime", "localDateTime", "offsetDateTime", and "zonedDateTime); ignored otherwise.

|pattern | _true_
|String |Custom
@@ -4914,6 +4915,7 @@ formatting pattern which determines how the date string is to be parsed.
|String or java.util.TimeZone
|Time zone in which to interpret any time
information in the date string.
Applied only when _type_ corresponds to _java.util.Date_; ignored otherwise.

|parseLocale |
_true_ a|
@@ -4929,7 +4931,7 @@ applied.
| _var_ | _false_
| _String_ |Name
of the exported scoped variable in which the parsing result (of type
_java.util.Date_) is stored.
_java.util.Date_ or _java.time.temporal.Temporal_) is stored.

| _scope_ |
_false_ | _String_