setDateFormat
Creates a format that can be used with Date values. Note that Date and DateTime values are separate types as are their formats - despite both including date information, this command produces a format only for Date values. Use the setDateTimeFormat command to produce a format for the more accurate time values.
Attributes
name | ||
|---|---|---|
Required | Value type | EL-evaluated |
No | String | Yes |
Defines a name for the created format. If defined, other commands can choose to use this format by referring to it by this name. Leaving the created format nameless declares it as the default format for Date values. Any command that prints out a Date value will then use this format, unless the command specifies a named format for itself. If a default format for Date values has already been set, this new format will take its place as the default. | ||
locale | ||
|---|---|---|
Required | Value type | EL-evaluated |
No | String | Yes |
Specifies a locale for this format, affecting the formatting rules. The resolved String should be an ISO-639 language code and an ISO-3166 country code, joined by a hyphen or an underscore (eg. "en-US" or "en_US"). Alternatively the value may only specify the language code, but this may lead to unpredictable results if this format requires the country information. If not defined, the format will follow the user's default locale. | ||
pattern | ||
|---|---|---|
Required | Value type | EL-evaluated |
No | String | Yes |
The value of this attribute is used as the pattern defining what kind of Strings this format will produce. If not defined, a locale-dependent standard pattern will be used. | ||
Examples
Basic Date formats, with either day or month being the first value:
<setDateFormat name="dayFirst" pattern="dd.MM.yyyy"><setDateFormat name="monthFirst" pattern="MM.dd.yyyy"> These would print out the Date of 31st of October in 2018 as "31.10.2018" and "10.31.2018".