locale : string; the name of a locale to use

Dates (and Time objects) can be formatted to a string by using the Format( d, fmt ) command.

A string containing date information can be parsed to produce a corresponding Date object by using the Parse( s, fmt ) command.

The format string fmt is a string of free-form text with embedded formatting codes specified in the Unicode Technical Standard #35. Note that literal text in fmt must be quoted with single (forward) quotes (').

For an alternative way to provide format strings, see Calendar[VariantFormat].

The format string fmt is optional. Its default value is the string "yyyy-MM-dd'T'HH:mm:ss zzz".

Use the locale = loc option to control which locale formatting and parsing occurs in. The loc value should be a two-letter language code (E.g., "id" for Indonesian), optionally separated by an underscore character ("_") from a country variant indicates by using a two- or three-letter country code. (E.g., "fr_CA" for Canadian French.)

For some of the examples below to print correctly, you may need special fonts to be installed on your computer.

$\mathrm{with}\left(\mathrm{Calendar}\right)\:$

$s≔\mathrm{Format}\left(\mathrm{Today}\left(\right)\right)$

$s≔''2024-03-01T05:38:42\; UTC''$

$\mathrm{Parse}\left(s\right)$

$\mathrm{<Date:\; 2024-03-01T05:38:42\; GMT>}$

$\mathrm{Format}\left(\mathrm{Today}\left(\right)\&comma;''\text{'}The\; day\; of\; the\; week\; is\; \text{'}eeee''\right)$

$''The\; day\; of\; the\; week\; is\; Friday''$

$s≔\mathrm{Format}\left(\mathrm{Today}\left(\right)\&comma;''EEEE,\; MMMM\; dd,\; yyyy\; GG\; \text{'}at\text{'}\; hh:mm:ss\; a''\right)$

$s≔''Friday,\; March\; 01,\; 2024\; AD\; at\; 05:38:42\; AM''$

$\mathrm{Parse}\left(s\&comma;''EEEE,\; MMMM\; dd,\; yyyy\; GG\; \text{'}at\text{'}\; hh:mm:ss\; a''\right)$

$\mathrm{<Date:\; 2024-03-01T05:38:42\; GMT>}$

$t≔\mathrm{Format}\left(\mathrm{Now}\left(\mathrm{SystemUTCClock}\right)\right)$

$t≔''2024-03-01T05:38:42\; UTC''$

$\mathrm{Parse}\left(t\right)$

$\mathrm{<Date:\; 2024-03-01T05:38:42\; GMT>}$

$\mathrm{Format}\left(\mathrm{Today}\left(\right)\&comma;''EEEE,\; MMMM\; dd,\; yyyy\; GG,\; hh:mm:ss\; a''\&comma;'\mathrm{locale}'=''ja''\right)$

$''金曜日,\; 3月\; 01,\; 2024\; 西暦,\; 05:38:42\; 午前''$

$\mathrm{Format}\left(\mathrm{Today}\left(\right)\&comma;''EEEE,\; MMMM\; dd,\; yyyy\; GG\; \text{'}jam\text{'}\; hh:mm:ss\; a''\&comma;'\mathrm{locale}'=''id''\right)$

$''Jumat,\; Maret\; 01,\; 2024\; M\; jam\; 05:38:42\; AM''$

$s≔\mathrm{Format}\left(\mathrm{Today}\left(\right)\&comma;''EEEE,\; MMMM\; dd,\; yyyy\; GG\; \text{'}um\text{'}\; hh:mm:ss\; a''\&comma;'\mathrm{locale}'=''de''\right)$

$s≔''Freitag,\; März\; 01,\; 2024\; n.\; Chr.\; um\; 05:38:42\; AM''$

$\mathrm{Parse}\left(s\&comma;''EEEE,\; MMMM\; dd,\; yyyy\; GG\; \text{'}um\text{'}\; hh:mm:ss\; a''\&comma;'\mathrm{locale}'=''de''\right)$

$\mathrm{<Date:\; 2024-03-01T05:38:42\; GMT>}$

$s≔\mathrm{Format}\left(\mathrm{Date}\left(-42\&comma;3\&comma;15\&comma;3\&comma;4\&comma;5\right)\&comma;''EEEE,\; MMMM\; dd,\; yyyy\; GGGGGGG\; \text{'}jam\text{'}\; hh:mm:ss\; a''\&comma;'\mathrm{locale}'=''id''\right)$

$s≔''Kamis,\; Maret\; 15,\; 0043\; SM\; jam\; 03:04:05\; AM''$

$\mathrm{Parse}\left(s\&comma;''EEEE,\; MMMM\; dd,\; yyyy\; GGGGGGG\; \text{'}jam\text{'}\; hh:mm:ss\; a''\&comma;'\mathrm{locale}'=''id''\right)$

$\mathrm{<Date:\; 0043-03-15T03:04:05\; GMT>}$

Unicode Technical Standard #35

ISO 639.2

The Calendar[Format] and Calendar[Parse] commands were introduced in Maple 2019.

For more information on Maple 2019 changes, see Updates in Maple 2019.