locale : string; the name of a locale to use

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

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

The format string fmt is a string of free-form text with format conversion specifiers similar to those used by printf.

The format string fmt is optional.  Its default value is the string "%Y-%m-%dT%T".

A richer set of formatting and parsing specifiers are provided by Calendar[Format] and Calendar[Parse]. The VariantFormat and VariantParse commands are intended to be similar to the facilities provided by StringTools[FormatTime] and StringTools[ParseTime] commands.

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.

The following table details the supported format conversion specifiers.

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

$\mathrm{VariantFormat}\left(\mathrm{Today}\left(\right)\,''The\; day\; of\; the\; week\; is\; \%A''\right)$

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

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

$s≔''2023-03-08T11:47:25''$

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

$\mathrm{Date}\left(2023\,3\,8\,11\,47\,25\,\mathrm{timezone}\=''UTC''\,\mathrm{coefficient}\=1\right)$

$\mathrm{seq}\left(\mathrm{printf}\left(''\%\%\%c\; -\; \%s''\,\mathrm{ch}\,\mathrm{StringTools}:-\mathrm{Visible}\left(\mathrm{VariantFormat}\left(\mathrm{Today}\left(\right)\,\mathrm{cat}\left(''\%''\,\mathrm{ch}\right)\right)\right)\right)\,\mathrm{ch}\=''\%aAbBcDgGHIjmMnprRStTuUVwxXyYzZ''\right)$

%%        -        %
%a        -        Wed
%A        -        Wednesday
%b        -        Mar
%B        -        March
%c        -        Wed Mar 08 11:47:26 2023
%D        -        03/08/23
%g        -        23
%G        -        2023
%H        -        11
%I        -        11
%j        -        067
%m        -        03
%M        -        47
%n        -        \10
%p        -        AM
%r        -        11:47:26 AM
%R        -        11:47
%S        -        26
%t        -        \9
%T        -        11:47:26
%u        -        4
%U        -        10
%V        -        10
%w        -        4
%x        -        03/08/23
%X        -        11:47:26
%y        -        23
%Y        -        2023
%z        -        +0000
%Z        -        Etc/UTC

$\mathrm{VariantFormat}\left(\mathrm{Today}\left(\right)\,''\%c''\,\'\mathrm{locale}\'\=''ja''\right)$

$''水\; 3月\; 08\; 11:47:26\; 2023''$

$s≔\mathrm{VariantFormat}\left(\mathrm{Today}\left(\right)\,''\%c''\,\'\mathrm{locale}\'\=''de''\right)$

$s≔''Mi.\; März\; 08\; 11:47:26\; 2023''$

$\mathrm{VariantParse}\left(s\,''\%c''\,\'\mathrm{locale}\'\=''de''\right)$

$\mathrm{Date}\left(2023\,3\,8\,11\,47\,26\,\mathrm{timezone}\=''UTC''\,\mathrm{coefficient}\=1\right)$

ISO 639.2

The Calendar[VariantFormat] and Calendar[VariantParse] commands were introduced in Maple 2019.

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