Formatchars
Date and time formatting characters
Various date and time formatting routines accept a format string to format the date and or time. The following characters can be used to control the date and time formatting:
- c
- Formats date using shortdateformat and formats time using longtimeformat if the time is not zero.
- f
- Same as c, but adds the time even if it is zero.
- d
- day of month
- dd
- day of month (leading zero)
- ddd
- day of week (abbreviation)
- dddd
- day of week (full)
- ddddd
- shortdateformat
- dddddd
- longdateformat
- m
- month or minutes if preceded by h or hh specifiers.
- mm
- month or minutes if preceded by h or hh specifiers, with leading zero.
- mmm
- month (abbreviation)
- mmmm
- month (full)
- y
- year (2 digits)
- yy
- year (two digits)
- yyyy
- year (with century)
- h
- hour
- hh
- hour (leading zero)
- n
- minute
- nn
- minute (leading zero)
- s
- second
- ss
- second (leading zero)
- t
- shorttimeformat
- tt
- longtimeformat
- am/pm
- use 12 hour clock and display am and pm accordingly
- a/p
- use 12 hour clock and display a and p accordingly
- /
- insert date separator
- :
- insert time separator
- "xx"
- literal text
- 'xx'
- literal text
- z
- milliseconds
- zzz
- milliseconds(leading zero)
- [h]
- hours including the hours of the full days (i.e. can be > 24).
- [hh]
- hours with leading zero, including the hours of the full days (i.e. can be > 24)
- [n]
- minutes including the minutes of the full hours and days
- [nn]
- minutes with leading zero, including the minutes of the full hours and days
- [s]
- seconds including the seconds of the full minutes, hours and days.
- [ss]
- seconds with leading zero, including the seconds of the full minutes, hours and days.
The forms in square brackets are only allowed if the fdoInterval option is included in the Options argument of FormatDateTime.
The date and time separators are taken from the DefaultFormatSettings record, unless a TFormatSettings record is passed to the FormatDateTime function.
Note that to include any of the above characters literally in the result string, they must be enclosed in double quotes.
See also
| Name | Description |
|---|---|
| DefaultFormatSettings | Storage for default settings |
| FormatDateTime | Return a string representation of a TDateTime value with a given format. |
| TFormatDateTimeOption | Additional options for FormatDateTime |
| TFormatSettings | Record with all the strings that determine formatting |