Выражения с датой и датой-временем

Ниже приведены примеры выражений отчета для вопросов с датой и датой-временем.

Примечание:

Эти выражения не применяются к вопросам типа Время, которые хранятся в виде строк.

Чтобы вопросы типа Дата и Дата-время точно соответствовали формату вашего региона, можно использовать выражение, форматирующее эти вопросы в соответствии с заданной локалью. Метод locale должен быть помещен в начало выражения, а код локали должен быть указан в нижнем регистре:

${datetime | locale:"pt-br"}

Примечание:

Более подробно о кодах локалей см. статью Wikipedia Список кодов ISO 639-1. Однако не все эти языки поддерживаются в Survey123.

Все значения даты и даты-времени в векторном слое хранятся в формате времени UTC. По умолчанию, все значения даты и даты-времени, возвращаемые в отчете, находятся в том же часовом поясе, что и веб-браузер, который используется для запроса создания отчета. Метод utcOffset можно использовать для изменения отображения этих значений в отчете для соответствия определенному часовому поясу. Следующее выражение покажет ответ на вопрос даты-времени со смещением в один час от UTC:

${datetime | utcOffset:"+01:00"}

Метод utcOffset поддерживает форматы +01:00, +0100 и +01 и возвращает тот же результат. Этот метод также можно применять для изменения отображения времени подтверждения ответа.

Для вопросов типа Дата и Дата-время выражение может использоваться для выбора формата, при этом используются заместители DD, MM и YYYY для дней, месяцев и годов соответственно. В следующем выражении отображается только день и месяц, год пропускается:

${date | format:"DD/MM"}

Также можно форматировать время в вопросах Дата-время, используя HH, mm и ss для часов, минут и секунд, соответственно. В следующем выражении отображается день, месяц, часы и минуты:

${datetime | format:"DD/MM HH:mm"}

Вы можете отобразить даты и время в формате ISO 8601 YYYY-MM-DDTHH:mm:ss±HH:mm, оставив значение для метода format пустым, как показано в следующем примере:

${datetime | format:""}

Для получения дополнительной информации о форматах даты и времени см. таблицу ниже.

Примечание:

Метод format должен быть помещен в конец выражения.

Вы можете напечатать дату и время создания отчета, используя ключевое слово $date. Используйте метод format для управления печатью даты, времени или и того, и другого. Следующий пример выводит дату создания отчета (без времени) в формате даты по умолчанию для вашего региона:

${$date}

Следующее выражение выводит месяц, день, год, часы и минуты для даты и времени создания отчета:

${$date | format:"MM/DD/YYYY HH:mm"}

Следующее выражение выводит время создания отчета (без даты) в часах, минутах и ​​секундах в 12-часовом формате:

${$date | format:"h:mm:ss A"}

Ключевое слово $date также поддерживает методы utcOffset и locale. Метод locale игнорируется, если заданы обе опции format и locale.

Форматы даты и времени

В следующей таблице перечислены наиболее распространенные заполнители, которые можно использовать в методе format для форматирования даты и времени в вопросах типа Дата и Дата-время в отчете:

Заполнитель	Описание
YY	Две последние цифры года. Пример: 2023 будет представлен как 23.
ГГГГ	Четыре цифры года. Пример: 2023 будет представлен как 2023.
М	Номер месяца от 1 до 12. Пример: январь будет представлен как 1.
MM	Номер месяца двумя цифрами. Пример: январь будет представлен как 01.
MMM	Месяц тремя буквами. Пример: Январь будет представлен как Янв
MMMM	Полное название месяца. Пример: Январь будет представлен как Январь
D	День месяца от 1 до 31. Пример: Первое число месяца будет представлено как 1.
DD	День месяца двумя цифрами. Пример: Первое число месяца будет представлено как 01.
Do	День месяца, который включает порядковый суффикс. Пример: Первый день месяца будет обозначен как 1е.
H	Час по 24-часовому диапазону. Пример: 11 часов вечера будет представлено как 23.
HH	Час по 24-часовому диапазону двумя цифрами. Пример: 2 часа ночи будет представлено как 02.
h	Час по 12-часовому диапазону. Пример: 11 часов ночи будет представлено как 11.
hh	Час по 12-часовому диапазону двумя цифрами. Пример: 2 часа ночи будет представлено как 02.
m	Минута от 0 до 59. Пример: 8 минут будет представлено как 8.
mm	Число минут двумя цифрами. Пример: 8 минут будет представлено как 08.
ss	Число секунд двумя цифрами. Например, 9 секунд будут показаны как 09.
Z	Смещение часового пояса в часах с использованием разделителя. Примеры: -07:00, +13:00
ZZ	Смещение часового пояса в часах без использования разделителя. Примеры: -0700, +1300
x	Время в миллисекундах в формате UNIX. Пример: 9 часов вечера 4 мая 2023 GMT будет представлено как 1683234000000.
X	Время в формате UNIX. Пример: 9 часов вечера 4 мая 2023 GMT будет представлено как 1683234000.
a	Запись строчными буквами обозначения утра или полудня. Пример: a.m. будет представлено как am, а p.m. будет представлено как pm.
A	Запись заглавными буквами обозначения утра или полудня. Пример: a.m. будет представлено как AM, а p.m. будет представлено как PM.