date

Назначение

Функция date позволяет изменять тип входного значения на тип дата. Например, значение строкового типа данных можно перевести в значение данных типа дата. Изменение типа данных называется преобразование или приведение типов.

Функция date используется для создания значения типа дата путем парсинга строкового значения в соответствии с указанным форматом даты. Например, если в строке содержится "12/01/2006", то, используя функцию date, можно выполнить парсинг в значение данных типа дата.

Синтаксис

date(значение)

Аргументы

Функция date требует наличия двух аргументов, каждый из которых должен быть строковым типом данных.

Первый обязательный аргумент - значение для парсинга. Этот аргумент должен содержать символы, обозначающие дату, например "12/01/2006", "2006/12/01" or "2005/04/02 10:20:33". Аргумент может содержать дату и время, время и дату (обычно обратный порядок даты и времени), только дату или только время. Если присутствуют и дата, и время, то порядок этих значений критичен, поскольку его нужно правильно установить во втором аргументе.

Второй необязательный аргумент представлен элементами из набора именованных параметров. Эти параметры определяют, как функция будет выполнять парсинг компонентов даты из первого аргумента (который включает дни, месяцы, годы, время и т.д.).

  • date_format

  • date_time_order

  • nan_name

Если в строке нет разделителей для года, месяца и дня, можно использовать следующее:

  • YMD - принимает такие строки, как 19910413, 91APR13 и 910413.

  • DMY - принимает такие строки, как 13041991, 13APR91, and 130491.

Если в строке есть разделители (слеши и точки), то в зависимости от порядка можно использовать: YMD, YDM, MDY, MYD, DMY, DYM, YM, MY.

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

Функция возвращает значение даты.

Функция возвращает нулевое значение, если:

  • происходит сбой в анализе значений дат;

  • один из аргументов является пустым;

  • во втором аргументе используется неверный синтаксис.

Примеры

Expression

Return Value

date("2019-02-21 11:22:34", date_time_order:="DT", date_format:="YMD")

2/21/2019 11:22:34 AM

date("2019-02-21 11:22:34", date_time_order:="DT", date_format:="YMD")

2/21/2019 11:22:34 AM

date("11:22:34 2019-02-04", date_time_order:="TD", date_format:="YMD")

2/21/2019 11:22:34 AM

date("02-21-2019 23:22:34", date_time_order:="DT", date_format:="MDY")

2/21/2019 11:22:34 PM

date("02-2019-21 03:22:34", date_time_order:="DT", date_format:="MYD")

2/21/2019 3:22:34 AM