Функция ER DATETIMEFORMAT

Функция DATETIMEFORMAT возвращает значение типа Строка, которое представляет заданное значение даты/времени в виде текста в указанном формате и в дополнительно указанной культуре. Сведения о поддерживаемых форматах см. в разделах стандартный и настраиваемый.

Синтаксис 1

DATETIMEFORMAT (datetime, format)

Синтаксис 2

DATETIMEFORMAT (datetime, format, culture)

Аргументы

datetime: Дата и время

Значение даты/времени, представляющее дату и время для формата.

format: Строка

Формат строки вывода. Сведения о поддерживаемых форматах см. в разделах стандартный и настраиваемый.

Примечание

В строке форматирования учитывается регистр при использовании стандартного или пользовательского формата. Например, стандартный спецификатор формата "d" возвращает дату, используя короткий шаблон даты, в то время как стандартный спецификатор формата "D" возвращает дату, используя полный шаблон даты. Кроме того, пользовательский спецификатор формата "M" возвращает месяц от 1 до 12, в то время как пользовательский спецификатор формата "m" возвращает минуты от 0 до 59.

culture: Строка

Культура для форматирования. Сведения о поддерживаемых культурах см. в разделе Культура.

Возвращаемые значения

Строка

Результирующее значение строки.

Примечания по использованию

Если культура не определена как аргумент вызываемой функции, значение culture определяется контекстом вызова. Например, если функция DATETIMEFORMAT вызывается с помощью синтаксиса 1 в формате электронной отчетности (ER) для элемента FILE, настроенного на использование немецкой культуры, преобразование будет осуществляться с помощью немецкой культуры. Значение шаблона culture по умолчанию — EN-US.

Когда функция DATETIMEFORMAT преобразует заданное значение даты/времени, она учитывает настройки часового пояса пользователя приложения, который использует формат ER, в контексте которого вызывается функция.

Пример 1

DATETIMEFORMAT (NOW(), "dd-MM-yyyy") возвращает текущую дату/время сервера приложений, 24 декабря 2015, как "24-12-2015", на основе указанного настраиваемого формата.

Пример 2

DATETIMEFORMAT (SESSIONNOW(), "d", "DE") возвращает значение текущей даты/времени сеанса приложения, 24 декабря 2015 года, как строку "24.12.2015" на основе выбранной немецкой культуры и указанного формата.

Пример 3

DATETIMEFORMAT (DATETIMEVALUE( "2019-11-12T09:00:00.0000000-07:00", "O"), "O") возвращает значение строки 2019-11-12T08:00:00.0000000-08:00, когда эта функция вызывается во время процесса, инициированного пользователем приложения со значением часового пояса (GMT-08:00), Тихоокеанское время (США и Канада) в разделе Настройки языка и страны/региона.

Дополнительные ресурсы

Функции даты и времени