Skip to main content
Skip table of contents

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 (e.g. "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:

CODE
<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".

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.