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.