Пользовательские форматы даты и времени для функции 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».