Даты и их компоненты
Для задания формата представления даты/времени или извлечения их составляющих (месяц, квартал, минуты и т.п.) введены дополнительные функции. В приложениях ворд и эксель это достигается с применением встроенных возможностей, поэтому данные функции поддерживаются только в настройках шаблонов и текстовых шаблонах.
Макроопределение даты/времени - формат представления текущей даты/времени, который имеет следующую форму записи:
%<формат даты/времени>%
Допустимые форматы даты/времени представлены в таблице ниже. Такая запись в процессе заполнения шаблонов будет заменена значением текущей даты/времени в соответствии с указанным форматом.
!!! Для вычисления всех макроопределений даты/времени используется дата/время начала сессии заполнения шаблонов. Это означает, что для всех макроопределений даты/времени при формировании пакета документов независимо от его длительности будет использовано одно и то же значение, определенное в момент начала заполнения.
Для формата представления даты/времени, сформированных с использованием значений метаданных используется функция «Формат» со следующими формами записи:
#Format <формат даты/времени>, <значение># или
#Формат <формат даты/времени>, <значение>#
<значение> - метаданные дополненные при необходимости произвольным текстом отделенный от описателя формата запятой с пробелом.
Контекстные меню текстовых полей настройки шаблонов содержат наиболее востребованные форматы для их быстрой вставки, подменю:
- «Дата …» и «Время …» для вставки макроопределений;
- «Функции …»/»Представление даты …» для вставки функции «Формат».
Формат даты/времени – текст, включающий предопределенные описатели формата, указывающие на способ представления соответствующей компоненты даты/времени, а его позиция на место вставки значения компоненты.
|
Описатель формата |
Описание |
Примеры |
|
d |
День месяца, в диапазоне от 1 до 31. |
01.09.2009 -> 1 15.06.2009 -> 15 |
|
dd |
День месяца, в диапазоне от 01 до 31. |
01.09.2009 -> 01 15.06.2009 -> 15 |
|
ddd |
Сокращенное название дня недели. |
15.06.2009 -> Пн |
|
dddd |
Полное название дня недели. |
15.06.2009 -> понедельник |
|
h |
Час в 12-часовом формате от 1 до 12. |
13:45:30 -> 1 |
|
HH |
Час в 12-часовом формате от 01 до 12. |
13:45:30 -> 01 |
|
H |
Час в 24-часовом формате от 0 до 23. |
01:45:30 -> 1 |
|
HH |
Час в 24-часовом формате от 00 до 23. |
01:45:30 -> 01 |
|
m |
Минуты, в диапазоне от 0 до 59. |
13:09:30 -> 9 |
|
mm |
Минуты, в диапазоне от 00 до 59. |
13:09:30 -> 09 |
|
M |
Месяц, в диапазоне от 1 до 12. |
15.06.2009 -> 6 |
|
MM |
Месяц, в диапазоне от 01 до 12. |
15.06.2009 -> 06 |
|
MMM |
Сокращенное название месяца. |
15.06.2009 -> Июн |
|
MMMM |
Полное название месяца. |
15.06.2009 -> Июнь |
|
s |
Секунды, в диапазоне от 0 до 59. |
13:45:09 -> 9 |
|
ss |
Секунды, в диапазоне от 00 до 59. |
13:45:09 -> 09 |
|
t |
Первый символ указателя AM/PM (до полудня/после полудня). |
13:45:09 -> P |
|
tt |
Указатель AM/PM (до полудня/после полудня). |
13:45:09 -> PM |
|
q |
Квартал в виде числа |
15.06.2009 -> 2 |
|
Q |
Квартал римскими цифрами |
10.10.2009 -> IV |
|
y |
Год, в диапазоне от 0 до 99. |
15.06.2009 -> 9 |
|
yy |
Год, в диапазоне от 00 до 99. |
15.06.2009 -> 09 |
|
yyyy |
Год в виде четырехзначного числа. |
15.06.2009 -> 2009 |
|
Y |
Последняя цифра года от 0 до 9. |
15.06.2019 -> 9 |
|
: |
Разделитель компонентов времени. |
-> : |
|
/ |
Разделитель компонентов даты. |
-> . |
|
'строка' |
Буквенный разделитель строк. |
15.06.2009 (y 'год') -> 9 год |
Например, пусть текущая дата: 1 января 2019 года,
тогда макроопределение:
%yyyy 'год'-MM%
будет заменено значением: 2019 год-01