Функции работы с датами и временем. Задание спецификаторов
Примечание 1.
Правила задания спецификатора формата для даты и времени отличаются от рассмотренных выше. В первую очередь надо иметь в виду то, что функции вроде FormatDateTime оперируют над одним значением TDateTime, а спецификаторы формата извлекают из него те или иные составные части. При этом могут использоваться:
С |
Отображает дату, используя формат ShortDateFormat, затем отображается время в формате LongTimeFormat. Время не отображается, если дробная часть переменной DateTime нулевая. |
D |
Отображает число месяца без нуля в левом разряде (1-31). |
Dd |
Отображает число месяца с нулем в левом разряде (01-31). |
Ddd |
Отображает день недели в соответствии с сокращенными именами из переменной ShortDayNames. |
dddd |
Отображает день недели в соответствии с полными именами из переменной LongDayNames. |
ddddd |
Отображает дату в соответствии с форматом ShortDateFormat. |
dddddd |
Отображает дату в соответствии с форматом LongDateFormat. |
M |
Отображает месяц как число без нуля в левом разряде (1-12). |
Mm |
Отображает месяц как число с нулем в левом разряде (01-12). |
Mmm |
Отображает месяц в соответствии с сокращенными именами из переменной ShortMonthNames. |
mmmm |
Отображает месяц в соответствии с полными именами из переменной LongMonthNames. |
УУ |
Отображает год двумя цифрами. |
УУУУ |
Отображает год четырьмя цифрами. |
H |
Отображает час как число без нуля в левом разряде (0-23). |
Hh |
Отображает час как число с нулем в левом разряде (00-23). |
N |
Отображает минуты как число без нуля в левом разряде (0-59). |
Nn |
Отображает минуты как число с нулем в левом разряде (00-59). |
S |
Отображает секунды как число без нуля в левом разряде (0-59). |
Ss |
Отображает секунды как число с нулем в левом разряде (00-59). |
T |
Отображает время в соответствии с форматом ShortTimeFormat. |
Tt |
Отображает время в соответствии с форматом LongTimeFormat. |
am/pm |
Отображает время в 12-часовой шкале. 'AM' означает часы до полудня, ТМ' ? часы после полудня. |
ampm |
Отображает время в 12-часовой шкале. При этом для времени до полудня отображается содержимое переменной TimeAMString, а после полудня ? TimePMString. |
a/p |
Отображает время в 12-часовой шкале, 'а' означает часы до полудня, 'р' ? часы после полудня. |
/ |
Отображает символ разделитель даты, содержащийся в переменной DataSeparator. |
: |
Отображает символ разделитель времени, содержащийся в переменной TimeSeparator. |
'XX'/"XX" |
Символы, заключаемые в простые или двойные кавычки, отображаются как есть и не подвергаются форматированию. |
Например, результатом вызова функции с параметрами
FormatDateTime (' "Совещание состоится в" dddd, dirrrrnm, yyyy, ' + ' "в" hh:nn', StrToDateTime('12/31/95 23:55'));
будет строка 'Совещание состоится в среду, 31 декабря 1995 в 23:55' (естественно, если вы переопределили значения элементов массива LongMonthNames).
Примечание 2. Спецификаторы am/pm, ampm, a/p используются вместе со спецификаторами h и hh.
Примечание 3. Спецификаторы могут быть указаны как в верхнем, так и в нижнем регистрах символов ? это не играет роли.
Примечание 4. Начальные значения всех используемых при форматировании даты и времени переменных берутся из секции [int1] файла WIN.INI.