Литералы Даты И Времени

Литералы даты и времени

Для записи литералов даты и времени в Firebird используются сокращённые "C-style" выражения.Строковое представление даты и времени должно быть в одном из разрешённых форматов.

Синтаксис

<date_literal> ::= DATE <date>

<time_literal> ::= TIME <time>

<timestamp_literal> ::= TIMESTAMP <timestamp>

<date> ::=
  [YYYY<p>]MM<p>DD |
  MM<p>DD[<p>YYYY] |
  DD<p>MM[<p>YYYY] |
  MM<p>DD[<p>YY] |
  DD<p>MM[<p>YY]


<time> := HH[:mm[:SS[.NNNN]]] [<time zone>]

<timestamp> ::= <date> <time>

<time zone> ::=
    <time zone region> |
    [+/-] <hour displacement> [: <minute displacement>]

<p> ::= whitespace | . | : | , | - | /

Table 1. Описание формата даты и времени
Аргумент	Описание
datetime	Строковое представление даты-времени.
date	Строковое представление даты.
time	Строковое представление времени.
YYYY	Год из четырёх цифр.
YY	Последние две цифры года (00-99).
MM	Месяц.Может содержать 1 или 2 цифры (1-12 или 01-12). В качестве месяца допустимо также указывать трёх буквенное сокращение или полное наименование месяца на английском языке, регистр не имеет значение.
DD	День.Может содержать 1 или 2 цифры (1-31 или 01-31).
HH	Час.Может содержать 1 или 2 цифры (0-23 или 00-23).
mm	Минуты.Может содержать 1 или 2 цифры (0-59 или 00-59).
SS	Секунды.Может содержать 1 или 2 цифры (0-59 или 00-59).
NNNN	Десятитысячные доли секунды.Может содержать от 1 до 4 цифр (0-9999).
p	Разделитель, любой из разрешённых символов, лидирующие и завершающие пробелы игнорируются.
time zone region	Один из часовых поясов связанных с регионом.
hour displacement	Смещение времени для часов относительно GMT.
minute displacement	Смещение времени для минут относительно GMT.

Правила:

В формате Год-Месяц-День, год обязательно должен содержать 4 цифры;
Для дат в формате с завершающим годом, если в качестве разделителя дат используется точка ".", то дата интерпретируется в форме День-Месяц-Год, для остальных разделителей она интерпретируется в форме Месяц-День-Год;
Если год не указан, то в качестве года берётся текущий год;
Если указаны только две цифры года, то для получения столетия Firebird использует алгоритм скользящего окна. Задача заключается в интерпретации двух символьного значения года как ближайшего к текущему году в интервале предшествующих и последующих 50 лет;
Если в строковом представлении времени присутствует часовой пояс или смещение времени, то тип литерала будет WITH TIME ZONE, в противном случае WITHOUT TIME ZONE;
Если не указан один из элементов времени, то оно принимается равным 0.

Tip	Настоятельно рекомендуем в литералах дат использовать только формы с полным указанием года в виде 4 цифр во избежание путаницы.

Example 1. Примеры литералов дат и времени

SELECT
  date '04.12.2014' AS d1, -- DD.MM.YYYY
  date '12-04-2014' AS d2, -- MM-DD-YYYY
  date '12/04/2014' AS d3, -- MM/DD/YYYY
  date '04.12.14'  AS d4,   -- DD.MM.YY
  -- DD.MM в качестве года берётся текущий
  date '04.12' AS d5,
  -- MM/DD в качестве года берётся текущий
  date '12/4' AS d6,
  date '2014/12/04'  AS d7, -- YYYY/MM/DD
  date '2014.12.04'  AS d8, -- YYYY.MM.DD
  date '2014-12-04'  AS d9, -- YYYY-MM-DD
  time '11:37' AS t1, -- HH:mm
  time '11:37:12' AS t2, -- HH:mm:ss
  time '11:31:12.1234' AS t3, -- HH:mm:ss.nnnn
  -- HH:mm:ss.nnnn +hh
  time '11:31:12.1234 +03' AS t4,
  -- HH:mm:ss.nnnn +hh:mm
  time '11:31:12.1234 +03:30' AS t5,
  -- HH:mm:ss.nnnn tz
  time '11:31:12.1234 Europe/Moscow' AS t5,
  -- HH:mm tz
  time '11:31 Europe/Moscow' AS t6,
  -- DD.MM.YYYY HH:mm
  timestamp '04.12.2014 11:37' AS dt1,
  -- MM/DD/YYYY HH:mm:ss
  timestamp '12/04/2014 11:37:12' AS dt2,
  -- DD.MM.YYYY HH:mm:ss.nnnn
  timestamp '04.12.2014 11:31:12.1234' AS dt3,
  -- YYYY-MM-DD HH:mm:ss.nnnn +hh:mm
  timestamp '2014-12-04 11:31:12.1234 +03:00' AS dt4,
  -- DD.MM.YYYY HH:mm:ss.nnnn tz
  timestamp '04.12.2014 11:31:12.1234 Europe/Moscow' AS dt5
FROM rdb$database

Note

Обратите внимание, что эти сокращённые выражения вычисляются сразу же во время синтаксического анализа (подготовки запроса или компиляции процедуры, функции или триггера). До Firebird 4.0 сокращённые выражения позволялись также для специальных строковых литералов 'NOW', 'TODAY', 'TOMORROW', 'YESTERDAY'. Использование таких выражений в компилируемом PSQL приводило к тому, что значение "замораживалось" на момент компиляции, и возвращалось не актуальное значение.Поэтому в Firebird 4.0 сокращённые выражения для таких строковых литералов запрещены, однако вы можете использовать их при приведении типа оператором CAST.

См. также:

[fblangref-datatypes-convert-literalformats].

Операции, использующие значения даты и времени

Благодаря способу хранения даты и времени с этими типами возможны арифметические операции вычитания из более поздней даты (времени) более раннюю.Дата представлена количеством дней с "нулевой даты" – 17 ноября 1858 г.Время представлено количеством секунд (с учётом десятитысячных долей), прошедших с полуночи.

Table 1. Арифметические операции для типов данных даты и времени
Операнд 1	Оператор	Операнд 2	Результат
`DATE`	`+`	`TIME`	`TIMESTAMP`
`DATE`	`+`	`TIME WITH TIME ZONE`	`TIMESTAMP WITH TIME ZONE`
`DATE`	`+`	Числовое значение `n`	`DATE`, увеличенная на `n` целых дней (дробная часть игнорируется).
`TIME`	`+`	`DATE`	`TIMESTAMP`
`TIME WITH TIME ZONE`	`+`	`DATE`	`TIMESTAMP WITH TIME ZONE`
`TIME`	`+`	Числовое значение `n`	`TIME`, увеличенное на `n` секунд (дробная часть учитывается).
`TIME WITH TIME ZONE`	`+`	Числовое значение `n`	`TIME WITH TIME ZONE`, увеличенное на `n` секунд (дробная часть учитывается).
`TIMESTAMP`	`+`	Числовое значение `n`	`TIMESTAMP`, где дата будет увеличиваться на количество дней и на часть дня, представленную числом n - поэтому “`+ 2.75`” сдвинет дату вперед на 2 дня и 18 часов.
`TIMESTAMP WITH TIME ZONE`	`+`	Числовое значение `n`	`TIMESTAMP WITH TIME ZONE`, где дата будет увеличиваться на количество дней и на часть дня, представленную числом n - поэтому “`+ 2.75`” сдвинет дату вперед на 2 дня и 18 часов.
`DATE`	`-`	`DATE`	Количество дней в интервале как `DECIMAL (9, 0)`.
`DATE`	`-`	Числовое значение `n`	`DATE`, уменьшенная на `n` целых дней (дробная часть игнорируется).
`TIME`	`-`	`TIME`	Количество секунд в интервале как `DECIMAL (9, 4)`.
`TIME`	`-`	`n`	`TIME`, уменьшенное на `n` секунд (дробная часть учитывается).
`TIME`	`-`	`TIME WITH TIME ZONE`	Значение без часового пояса преобразуется в `WITH TIME ZONE` в часовом поясе текущего сеанса.Возвращается количество секунд в интервале между UTC значениями как `DECIMAL(9, 4)`.То же правило действует при изменении порядка операндов.
`TIME WITH TIME ZONE`	`-`	`TIME WITH TIME ZONE`	Возвращается количество секунд в интервале между UTC значениями как `DECIMAL(9, 4)`.
`TIMESTAMP`	`-`	`TIMESTAMP`	Количество дней и части дня в интервале как `DECIMAL (18, 9)`.
`TIMESTAMP`	`-`	`TIMESTAMP WITH TIME ZONE`	Значение без часового пояса преобразуется в `WITH TIME ZONE` в часовом поясе текущего сеанса.Количество дней и части дня в интервале между UTC значениями как `DECIMAL (18, 9)`.То же правило действует при изменении порядка операндов.
`TIMESTAMP`	`-`	`n`	`TIMESTAMP`, где дата будет уменьшена на количество дней, и часть дня, представленную числом n - поэтому “`- 2.25`” сдвинет дату назад на 2 дня и 6 часов.
`TIMESTAMP WITH TIME ZONE`	`-`	`n`	`TIMESTAMP WITH TIME ZONE`, где дата будет уменьшена на количество дней, и часть дня, представленную числом n - поэтому “`- 2.25`” сдвинет дату назад на 2 дня и 6 часов.

Одно значение даты/времени может быть вычтено из другого если:

Оба значения имеют один и тот же тип даты/времени;
Первый операнд является более поздним, чем второй.

Note	В диалекте 1 тип `DATE` рассматривается как `TIMESTAMP`.

См. также:

[fblangref-scalarfuncs-dateadd], [fblangref-scalarfuncs-datediff].