Функция ER DATETIMEVALUE
Функция DATETIMEVALUE
возвращает значение Дата и время, которое преобразуется из текстового значения в указанном формате и в дополнительно указанной культуре в значение даты/времени. Сведения о поддерживаемых форматах см. в разделах стандартный и настраиваемый.
Синтаксис 1
DATETIMEVALUE (text, format)
Синтаксис 2
DATETIMEVALUE (text, format, culture)
Аргументы
text
: Строка
Текст, представляющий значение для формата.
format
: Строка
Формат указанного текста. Сведения о поддерживаемых форматах см. в разделах стандартный и настраиваемый.
culture
: Строка
Культура, используемая для форматирования указанного текста. Сведения о поддерживаемых культурах см. в разделе Культура.
Возвращаемые значения
DateTime
Результирующее значение даты/времени.
Примечания по использованию
Когда культура не определена как аргумент вызываемой функции, значение culture
определяется контекстом вызова. Например, если функция DATETIMEVALUE
вызывается с помощью синтаксиса 1 в формате электронной отчетности (ER) для элемента FILE, настроенного на использование немецкой культуры, преобразование будет осуществляться с помощью немецкой культуры. Значение шаблона culture
по умолчанию — EN-US.
Пример 1
DATETIMEVALUE ("21-Dec-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss")
возвращает 2:55:00 21 декабря 2016 на основе указанного пользовательского формата и культуры приложения по умолчанию EN-US.
Пример 2
DATETIMEVALUE ("21-Gen-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss", "IT")
возвращает 2:55:00 21 декабря 2016 на основе указанного пользовательского формата и культуры.
Однако вызов DATETIMEVALUE ("21-Gen-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss", "EN-US")
вызывает исключение, информирующее пользователя, что указанная строка не распознана как допустимое значение даты/времени для указанной культуры.