date

Назначение

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

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

Синтаксис

date(строка,строка)

Аргументы

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

  1. Значение для парсинга.

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

  2. Формат даты, который определяет, как форматировать компоненты даты из первого аргумента, который представляет дни, месяцы, годы, время и т.д.).

    Формат даты состоит из 3 частей, разделенных точкой с запятой.

    • Первая часть - значение либо времени/даты, либо даты/времени. Используйте DT для данных Дата/Время и дат. Используйте TD для данных Время/Дата и времени.

    • Вторая часть - временной формат - 24-часовой или 12-часовой. Используйте 12 для 12-часового формата, используйте 24 для 24-часового формата.

    • Третья часть относится к порядку, в котором в первом строковом аргументе располагаются год, месяц и день. Y означает год, M - месяц, D - день.

      Если в строке нет разделителей для года, месяца и дня, можно использовать следующее: YYYYMMDD - принимает строковые данные, например 19910413, 91АПР13, и 910413. DDMMYYYY - принимает такие строки, как 13041991, 13АПР91, и 130491. Если в строке есть разделители (слеши и точки), то в зависимости от порядка можно использовать: YMD, YDM, MDY, MYD, DMY, DYM, YM, MY.

YMD означает порядок "год-месяц-день", DMY - "день-месяц-год".

"DT;24;YMD" означает: значение даты/времени, 24-часовой формат, год-месяц-день.

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

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

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

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

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

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

Примеры

Выражение

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

date("03/12/2006 21:12:22", "DT;24;DMY")

12/3/2006 9:12:22 PM

date("9:12:22 PM 2006/12/03", "TD;12;YMD")

12/3/2006 9:12:22 PM

date("12/03/2006 21:12", "DT;24;MDY")

12/3/2006 9:12:00 PM

date("12/03/2006", "DT;24;MDY")

12/3/2006 12:00:00 AM

date("9:12:22 PM", "TD;12;MDY")

12/30/1899 9:12:22 PM

date("03122006","DT;24;DDMMYYYY")

12/3/2006 12:00:00 AM