Пользовательские форматы даты и времени для функции FORMAT
В следующей таблице показаны символы, с помощью которых можно создавать определяемые пользователем форматы даты-времени.
Спецификация формата |
Описание |
|---|---|
(:) |
Разделитель компонентов времени. В некоторых локалях в качестве разделителя компонентов времени могут использоваться другие символы. Разделитель компонентов времени разделяет часы, минуты и секунды при форматировании значений времени. Символ, фактически используемый в качестве разделителя компонентов времени в отформатированном значении, зависит от текущего значения культуры в приложении. |
(/) |
Разделитель компонентов даты. В некоторых локалях и региональных стандартах в качестве разделителя компонентов даты могут использоваться другие символы. Разделитель компонентов даты разделяет день, месяц и год при форматировании значений даты. Символ, фактически используемый в качестве разделителя компонентов даты в отформатированном значении, зависит от текущего значения культуры в приложении. |
(%) |
Указывает, что следующий символ должен считываться в однобуквенном формате без учета последующих букв. Также может показывать, что однобуквенный формат считывается как определяемый пользователем формат. Дополнительные сведения см. далее. |
d |
Выводит день месяца в виде числа без ведущих нулей (например, 1). Если в определяемом пользователем числовом формате используется только один символ, используйте %d. |
dd |
Выводит день месяца в виде числа с ведущими нулями (например, 01). |
ddd |
Выводит сокращенное название дня недели (например, вс). |
dddd |
Выводит полное название дня недели (например, воскресенье). |
M |
Выводит месяц в виде числа без ведущих нулей (например, январь представляется числом 1). Если в определяемом пользователем числовом формате используется только один символ, используйте %M. |
ММ |
Выводит месяц в виде числа с ведущими нулями (например, 01/12/01). |
MMM |
Выводит сокращенное название месяца (например, янв). |
MMMM |
Выводит полное название месяца (например, январь). |
gg |
Отображает строку эры (например, н.э.) |
h |
Выводит часы в виде числа без ведущих нулей в 12-часовом формате (например, 1:15:15 PM). Если в определяемом пользователем числовом формате используется только один символ, используйте %h. |
hh |
Выводит часы в виде числа с ведущими нулями в 12-часовом формате (например, 01:15:15 PM). |
H |
Выводит часы в виде числа без ведущих нулей в 24-часовом формате (например, 1:15:15). Если в определяемом пользователем числовом формате используется только один символ, используйте %H. |
HH |
Выводит часы в виде числа с ведущими нулями в 24-часовом формате (например, 01:15:15). |
m |
Выводит минуты в виде числа без ведущих нулей (например, 12:1:15). Если в определяемом пользователем числовом формате используется только один символ, используйте %m. |
mm |
Выводит минуты в виде числа с ведущими нулями (например, 12:01:15). |
s |
Выводит секунды в виде числа без ведущих нулей (например, 12:15:5). Если в определяемом пользователем числовом формате используется только один символ, используйте %s. |
ss |
Выводит секунды в виде числа с ведущими нулями (например, 12:15:05). |
f |
Выводит доли секунды. Например, ff соответствует сотым долям секунды, а ffff — десятитысячным долям. В определяемом пользователем формате можно использовать до семи символов f. Если в определяемом пользователем числовом формате используется только один символ, используйте %f. |
t |
Выводит время в 12-часовом формате, добавляя букву A в верхнем регистре для времени до полудня и букву P в верхнем регистре для времени от полудня до 23:59. Если в определяемом пользователем числовом формате используется только один символ, используйте %t. |
tt |
В локалях, использующих 12-часовой формат времени, выводит сочетание AM в верхнем регистре для времени до полудня и сочетание PM в верхнем регистре для времени от полудня до 23:59. В локалях, использующих 24-часовой формат времени, не выводит ничего. |
y |
Выводит год без ведущих нулей (0-9). Если в определяемом пользователем числовом формате используется только один символ, используйте %y. |
yy |
Выводит год в виде двух цифр, в случае необходимости указываются ведущие нули. |
yyy |
Выводит год в формате из четырех цифр. |
yyyy |
Выводит год в формате из четырех цифр. |
z |
Выводит сдвиг часового пояса без ведущих нулей (например, -8). Если в определяемом пользователем числовом формате используется только один символ, используйте %z. |
zz |
Выводит сдвиг часового пояса с ведущими нулями (например, -08). |
zzz |
Выводит полный сдвиг часового пояса (например, -08:00). |
Замечания
В строках форматирования учитывается регистр. Изменение регистра символов позволяет изменить форматирование. Например, при форматировании значения даты строка «D» позволяет получить развернутое представление (в соответствии с текущей локалью). Если же изменить регистр строки (d), будет возвращено краткое представление даты. Если заданное форматирование не совпадает по регистру ни с одной из определенных строк форматирования, возможны ошибки или непредвиденные результаты.
В форматировании даты-времени для определения формата строки главным образом используется локаль текущего пользователя. Например, если дата «18 марта 1995 г.» форматируется строкой «M/d/yyyy» в локали США (ru-ru), то результатом будет «3/18/1995», а в локали Германии (de-de) — «18.03.1995».