Функция 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), Тихоокеанское время (США и Канада) в разделе Настройки языка и страны/региона.