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 quotes are displayed as-is and do not affect formatting |