Date-Time Format Strings
Date-time format strings specify the formatting of date-time values (such as TDateTime) when they are converted to strings. Date-time format strings are composed from specifiers that represent values to be inserted into the formatted string. Some specifiers (such as "d") format numbers or strings. Other specifiers (such as "/") refer to locale-specific strings from global variables. The case of the specifiers is ignored in formats, except for the "am/pm" and "a/p" specifiers.
Specifier | Display |
---|---|
c |
Date followed by time Note: The time is not displayed if the date-time value indicates midnight precisely. |
d |
Day as a number without a leading zero (1–31) |
dd |
Day as a number with a leading zero (01–31) |
ddd |
Day as an abbreviation (Sun-Sat) |
dddd |
Day as a full name (Sunday-Saturday) |
ddddd |
Short format of date |
dddddd |
Long format of date |
e |
Year in the current period/era as a number without a leading zero (Japanese, Korean, and Taiwanese locales only) |
ee |
Year in the current period/era as a number with a leading zero (Japanese, Korean, and Taiwanese locales only) |
g |
Period/era as an abbreviation (Japanese and Taiwanese locales only) |
gg |
Period/era as a full name (Japanese and Taiwanese locales only) |
m |
Month as a number without a leading zero (1–12) Caution: If the "m" specifier immediately follows an "h" or "hh" specifier, the minute rather than the month is displayed. |
mm |
Month as a number with a leading zero (01–12) Caution: If the "mm" specifier immediately follows an "h" or "hh" specifier, the minute rather than the month is displayed. |
mmm |
Month as an abbreviation (Jan-Dec) |
mmmm |
Month as a full name (January-December) |
yy |
Year as a two-digit number (00–99) |
yyyy |
Year as a four-digit number (0000–9999) |
h |
Hour without a leading zero (0–23) |
hh |
Hour with a leading zero (00–23) |
n |
Minute without a leading zero (0–59) |
nn |
Minute with a leading zero (00–59) |
s |
Second without a leading zero (0–59) |
ss |
Second with a leading zero (00–59) |
z |
Millisecond without a leading zero (0–999) |
zzz |
Millisecond with a leading zero (000–999) |
t |
Time using the format given by the ShortTimeFormat global variable |
tt |
Time using the format given by the LongTimeFormat global variable |
am/pm |
Uses the 12-hour clock for the preceding "h" or "hh" specifier, and displays "am" for any hour before noon, and "pm" for any hour after noon. The am/pm specifier can use lower, upper, or mixed case, and the result is displayed accordingly. |
a/p |
Uses the 12-hour clock for the preceding "h" or "hh" specifier, and displays "a" for any hour before noon, and "p" for any hour after noon. The a/p specifier can use lower, upper, or mixed case, and the result is displayed accordingly. |
ampm |
Uses the 12-hour clock for the preceding "h" or "hh" specifier |
/ |
Date separator character given by the regional settings |
: |
Time separator character given by the regional settings |
'xx'/"xx" |
Characters enclosed in single or double quotation marks are displayed as-is and do not affect formatting. |