This page is part of a static HTML representation of the TiddlyWiki at https://tiddlywiki.com/

DateFormat

 12th September 2021 at 11:51am

The default representation of dates is a compact string such as 20211002153802059. For example, the created and modified fields are stored like this.

The display format for this string can be controlled with a template. For example, transcluding the modified field automatically applies a template to display the date as Sat Oct 02 2021 17:40:50 GMT+0200 (Central European Summer Time). A few widgets and filter operators allow you to manually specify a template, for example the ViewWidget:

<$view field=modified format=date template=“DDth mmm YYYY 0hh:0mm:0ss” />

The date string is processed with the following substitutions:

TokenSubstituted Value
ddddd New in: 5.2.0 Day of year (1 to 365, or 366 for leap years)
0ddddd New in: 5.2.0 Zero padded day of year (001 to 365, or 366 for leap years)
DDDDay of week in full (eg, "Monday")
dddShort day of week (eg, "Mon")
dddd New in: 5.2.0 Weekday number from 1 through 7, beginning with Monday and ending with Sunday
DDDay of month
0DDAdds a leading zero
DDthAdds a suffix
WWISO-8601 week number of year
0WWAdds a leading zero
MMMMonth in full (eg, "July")
mmmShort month (eg, "Jul")
MMMonth number
0MMAdds leading zero
YYYYFull year
YYTwo digit year
wYYYYFull year with respect to week number
aYYYY New in: 5.1.23 Full year but negative dates are displayed as positive
wYYTwo digit year with respect to week number
{era:BCE||CE} New in: 5.1.23 Displays a different string for years that are negative, zero or positive (see below)
hhHours
0hhAdds a leading zero
hh12Hours in 12 hour clock
0hh12Hours in 12 hour clock with leading zero
mmMinutes
0mmMinutes with leading zero
ssSeconds
0ssSeconds with leading zero
XXXMilliseconds
0XXXMilliseconds with leading zero
am or pmLower case AM/PM indicator
AM or PMUpper case AM/PM indicator
TZDTimezone offset
\xUsed to escape a character that would otherwise have special meaning
[UTC]Time-shift the represented date to UTC. Must be at very start of format string

Note that other text is passed through unchanged, allowing commas, colons or other separators to be used.

The {era:BCE||CE} notation can specify different strings for years that are negative, zero or positive. For example {era:BC|Z|AD} would display BC for negative years, AD for positive years, and Z for year zero.

Examples

TemplateOutput
DDth MMM YYYY16th February 2011
DDth MMM \M\M\M YYYY16th February MMM 2011
DDth mmm YYYY 0hh:0mm:0ss16th Feb 2011 11:38:42