Calendar - Maple Programming Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Programming : Date and Time : Calendar package : Calendar/Format

Calendar

  

Format

  

format a Date or UTC Time object as a string

  

Parse

  

parse a string to a Date object with respect to a given format string

 

Calling Sequence

Parameters

Options

Description

Examples

References

Compatibility

Calling Sequence

Format( d, fmt )

Parse( s, fmt )

Parameters

d

-

Date; a Date object

s

-

string; string to parse

fmt

-

string; (optional) a format string

Options

• 

locale : string; the name of a locale to use

Description

• 

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.

Examples

withCalendar:

sFormatToday

s2020-03-05T03:48:04 UTC

(1)

Parses

Date2020,3,5,3,48,4,timezone=UTC,coefficient=1

(2)

FormatToday,'The day of the week is 'eeee

The day of the week is Thu

(3)

sFormatToday,EEEE, MMMM dd, yyyy GG 'at' hh:mm:ss a

sThu, M03 05, 2020 CE at 03:48:05 AM

(4)

Parses,EEEE, MMMM dd, yyyy GG 'at' hh:mm:ss a

Date2020,3,5,3,48,5,timezone=UTC,coefficient=1

(5)

tFormatNowSystemUTCClock

t2020-03-05T03:48:05 UTC

(6)

Note that the output of Parse is always a Date object; the source of the input string as a formatted Time object is unknown to the Parse command.

Parset

Date2020,3,5,3,48,5,timezone=UTC,coefficient=1

(7)

To use a locale different from the default locale, use the locale= option.

FormatToday,EEEE, MMMM dd, yyyy GG, hh:mm:ss a,locale=ja

木曜日, 3月 05, 2020 西暦, 03:48:05 午前

(8)

FormatToday,EEEE, MMMM dd, yyyy GG 'jam' hh:mm:ss a,locale=id

Kamis, Maret 05, 2020 M jam 03:48:05 AM

(9)

sFormatToday,EEEE, MMMM dd, yyyy GG 'um' hh:mm:ss a,locale=de

sDonnerstag, März 05, 2020 n. Chr. um 03:48:05 AM

(10)

Parses,EEEE, MMMM dd, yyyy GG 'um' hh:mm:ss a,locale=de

Date2020,3,5,3,48,5,timezone=UTC,coefficient=1

(11)

sFormatDate42,3,15,3,4,5,EEEE, MMMM dd, yyyy GGGGGGG 'jam' hh:mm:ss a,locale=id

sKamis, Maret 15, 0043 SM jam 03:04:05 AM

(12)

Parses,EEEE, MMMM dd, yyyy GGGGGGG 'jam' hh:mm:ss a,locale=id

Date42,3,15,3,4,5,timezone=UTC,coefficient=1

(13)

References

  

Unicode Technical Standard #35

  

ISO 639.2

Compatibility

• 

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

• 

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

See Also

Calendar

Calendar[VariantFormat]

Date

StringTools[FormatTime]

StringTools[ParseTime]