format
format(d: date, pattern: text) 🡒 text, const pure function
The format function provides a small formatting framework intended to convert a date its text counterpart. The first argument is the date to be formatted. The second argument is the pattern, a sequence of specifiers used to specify the intended formatting.
d = date(2022, 9, 26)
show summary "Formats" a1a3 with
format(d, "yyyy-MM-dd") // 2022-09-26
format(d, "M/dd/yy") // 9/29/22
format(d, "MMM d, yyyy") // Sept 26, 2022
The list of supported specifiers is given below.
| Specifier | Description | Source | Match |
|---|---|---|---|
y |
The year from 0 to 99. | 2019-06-05 | 19 |
y |
2001-01-28 | 1 | |
yy |
The year from 00 to 99. | 2001-06-05 | 19 |
yy |
2001-01-28 | 01 | |
yyy |
Same as yyyy |
||
yyyy |
The 4-digit year. | 2019-06-05 | 2019 |
yyyy |
2001-01-28 | 2001 | |
M |
The month from 1 to 12. | 2019-12-05 | 12 |
M |
2001-01-28 | 1 | |
MM |
The month from 01 to 12. | 2019-12-05 | 12 |
MM |
2001-01-28 | 01 | |
MMM |
The abbreviated month. | 2019-12-05 | Dec |
MMM |
2001-01-28 | Jan | |
MMMM |
The full-word month. | 2019-12-05 | December |
MMMM |
2001-01-28 | January | |
d |
The day from 1 to 31. | 2019-12-05 | 5 |
d |
2001-01-28 | 28 | |
dd |
The day from 01 to 31. | 2019-12-05 | 05 |
dd |
2001-01-28 | 28 | |
ddd |
The abbreviated weekday. | 2022-09-26 | Mon |
dddd |
The full-word weekday. | 2022-09-26 | Monday |
Any other character, that isn’t listed as a specifier, is written to the formatted output.
Some characters are reserved for future use: w, v and \.