datetime-format() #

string|boolean datetime-format(string format [, string|number timestamp = unixtime()])

Returns the given Unix timestamp as a string formatted according to format. If timestamp is missing or empty the current time is used. The local timezone set in the FLAT container’s TZ environment variable is taken into account.

Invalid values for format, timestamp or TZ result in datetime-format() returning false().

Examples #

<!-- timestamp set to 0 → January 1st 1970 was a Thursday. -->
<eval out="$jan-1st-1970">datetime-format('F jS Y \w\a\s \a l.', 0)</eval>

<!-- timestamp missing (= now) → 01-02-2023 (at time of this writing) -->
<eval out="$today">datetime-format('d-m-Y')</eval>

<!-- environment variable TZ=Europe/Berlin → CET = +01:00 -->
<eval out="$timezone">datetime-format('T = P')</eval>

<!-- invalid timestamp → false() -->
<eval out="$invalid">datetime-format('Y', 'invalid')</eval>

Format #

Escape any of the below formatting letters with a backslash (\) to output them literally.

See also #

• datetime-parse()
• datetime-parse-iso()
• unixtime()