Format - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


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

s2023-03-08T11:42:28 UTC

(1)

Parses

Date2023,3,8,11,42,28,timezone=UTC,coefficient=1

(2)

FormatToday,'The day of the week is 'eeee

The day of the week is Wednesday

(3)

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

sWednesday, March 08, 2023 AD at 11:42:28 AM

(4)

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

Date2023,3,8,11,42,28,timezone=UTC,coefficient=1

(5)

tFormatNowSystemUTCClock

t2023-03-08T11:42:28 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

Date2023,3,8,11,42,28,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月 08, 2023 西暦, 11:42:28 午前

(8)

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

Rabu, Maret 08, 2023 M jam 11:42:28 AM

(9)

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

sMittwoch, März 08, 2023 n. Chr. um 11:42:28 AM

(10)

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

Date2023,3,8,11,42,28,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]