Форматы даты и времени, определенные пользователем (функция Format)

Статья
11/05/2008

Обновлен: Ноябрь 2007

В следующей таблице приведены знаки, используемые для создания пользовательских форматов даты и времени. В отличие от более ранних версий Visual Basic, в этих знаках формата различается регистр.

Знак	Описание
(:)	Разделитель при указании времени. В некоторых языковых стандартах в качестве временного разделителя используются другие символы. Временной разделитель отделяет часы, минуты и секунды при форматировании временных значений. Фактический знак, используемый в качестве разделителя времени в отформатированных выходных данных, определяется текущими языковыми и региональными параметрами приложения.
(/)	Разделитель при указании даты. В некоторых региональных стандартах для представления разделителя даты используются другие символы. Разделитель даты отделяет день, месяц и год при форматировании значений дат. Фактический знак, используемый в качестве разделителя даты в отформатированных выходных данных, определяется текущими языковыми и региональными параметрами приложения.
(%)	Указывает, что следующий знак должен читаться, как однобуквенный формат без учета замыкающих букв. Служит также для указания, что односимвольный формат читается как определенный пользователем формат. Дополнительные сведения см. далее.
d	Отображает день в виде числа без нуля в начале (например, 1). Используйте %d, если это единственный знак в определяемом пользовательском числовом формате.
dd	Отображает день в виде числа с нулем в начале (например, 01).
ddd	Отображает сокращенное название дня (например, Sun).
dddd	Отображает название дня полностью (например, Sunday).
M	Отображает месяц в виде числа без нуля в начале (например, январь отображается как 1). Используйте %M, если это единственный знак в определяемом пользовательском числовом формате.
MM	Отображает месяц в виде числа с нулем в начале (например, 01/12/01).
MMM	Отображает сокращенное название месяца (например, Jan).
MMMM	Отображает полное название месяца (например, January).
gg	Отображает строку эры или периода (например, A.D.).
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 с любыми часами от полудня до 11:59 вечера. Используйте %t, если это единственный знак в определяемом пользовательском числовом формате.
tt	Для региональных стандартов, использующих 12-часовой формат, отображает прописные буквы AM с любыми часами до полудня; отображает прописные буквы PM с любыми часами от полудня до 11:59 вечера. Для региональных стандартов, использующих 24-часовой формат, не отображает ничего.
y	Отображает число года (0-9) без нулей в начале. Используйте %y, если это единственный знак в определяемом пользовательском числовом формате.
yy	Отображает год в числовом формате, состоящем из двух цифр с нулем в начале (если он необходим).
yyy	Отображает год в числовом формате, состоящем из четырех цифр.
yyyy	Отображает год в числовом формате, состоящем из четырех цифр.
z	Отображает разницу во времени между часовыми поясами без нуля в начале (например, -8). Используйте %z, если это единственный знак в определяемом пользовательском числовом формате.
zz	Отображает разницу во времени между часовыми поясами с нулем в начале (например, -08).
zzz	Отображает разницу во времени между часовыми поясами в полном формате (например, -08:00).

Дополнительные сведения о языке и региональных параметрах приложения см. в разделе Влияние языка и региональных параметров на строки в Visual Basic.

Пример

Далее приведены примеры пользовательских форматов даты и времени для December 7, 1958, 8:50 PM, 35 seconds:

Формат	Отображает
M/d/yy	12/7/58
d-MMM	7-Dec
d-MMMM-yy	7-December-58
d MMMM	7 December
MMMM yy	December 58
hh:mm tt	08:50 PM
h:mm:ss t	8:50:35 P
H:mm	20:50
H:mm:ss	20:50:35
M/d/yyyy H:mm	12/7/1958 20:50

Примечания для разработчиков приложений для смарт-устройств

Минимальный квант времени устройства определяется его изготовителем. Если квант времени для данного устройства достаточно велик, то знак формата f возвращает 0 при запуске на этом устройстве.