The ParseTime( fmt,str ) command parses the string str, assumed to contain date and time data, according to the parsing specification given by the format string fmt.

The time format string is a Maple string that can contain time and date format conversion specifiers, introduced by a $''\%''$ character. This works in a manner similar to the conversion specifiers used in printf or sscanf, but the defined conversion specifiers are different. The format conversion specifiers are a subset of those supported by the FormatTime procedure.

The string str to be parsed is assumed to contain date and time information in the format described by fmt. Characters in fmt and str are matched, with the format conversion specifiers in fmt acting as placeholders or wildcards for the actual date and time data present in the string str. If the two strings match, then the date and time data extracted from str are returned in the form of a record, described below. If the strings fail to match, then an exception is raised.

The following table lists the known conversion specifiers and their meanings.

The record returned by ParseTime contains slots with the following meanings and ranges of values.

Not all slots of this record will be updated for a given pair of inputs. Only those slots whose values can be determined from the given data will have meaningful values.

All of the StringTools package commands treat strings as (null-terminated) sequences of $8$-bit (ASCII) characters.  Thus, there is no support for multibyte character encodings, such as unicode encodings.

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

$\mathrm{dt}≔\mathrm{ParseTime}\left(''\%Y-\%m-\%d''\,''2002-11-05''\right)\:$

$\mathrm{dt}:-\mathrm{year},\mathrm{dt}:-\mathrm{month},\mathrm{dt}:-\mathrm{monthDay}$

$2002,11,5$

$\mathrm{dt}≔\mathrm{ParseTime}\left(''\%Y-\%m-\%d''\,''1964-01-14''\right)\:$

$\mathrm{dt}:-\mathrm{year},\mathrm{dt}:-\mathrm{month},\mathrm{dt}:-\mathrm{monthDay}$

$1964,1,14$

$\mathrm{dt}≔\mathrm{ParseTime}\left(''Welcome\; to\; the\; \%Cth\; Century!''\,''Welcome\; to\; the\; 19th\; Century!''\right)\:$

$\mathrm{dt}:-\mathrm{year}$

$1900$

$s≔\mathrm{FormatTime}\left(''\%c''\right)$

$s≔''Fri\; Mar\; 01\; 00:25:22\; 2024''$

$\mathrm{dt}≔\mathrm{ParseTime}\left(''\%c''\,s\right)$

$\mathrm{dt}≔\mathrm{Record}\left(\mathrm{calendar}=''Gregorian''\,\mathrm{second}=22\,\mathrm{minute}=25\,\mathrm{hour}=0\,\mathrm{monthDay}=1\,\mathrm{month}=3\,\mathrm{year}=2024\,\mathrm{weekDay}=6\,\mathrm{weekDayName}=''Friday''\,\mathrm{yearDay}=61\,\mathrm{dst?}=\mathrm{false}\right)$

$\mathrm{dt}:-\mathrm{second},\mathrm{dt}:-\mathrm{minute},\mathrm{dt}:-\mathrm{hour}$

$22,25,0$

$\mathrm{dt}:-\mathrm{monthDay},\mathrm{dt}:-\mathrm{month},\mathrm{dt}:-\mathrm{year}$

$1,3,2024$

$\mathrm{dt}:-\mathrm{weekDay},\mathrm{dt}:-\mathrm{yearDay}$

$6,61$

$\mathrm{ParseTime}\left(''\%Y-\%m-\%d''\,''1752-09-02''\right)\left[':-\mathrm{weekDay}'\right]$

$4$

$\mathrm{ParseTime}\left(''\%Y-\%m-\%d''\,''1752-09-14''\right)\left[':-\mathrm{weekDay}'\right]$

$5$