Самоучитель по SQL-сервер в Linux
         

Функции для работы с датой и временем

В PostgreSQL поддерживаются как стандартные функции SQL current_date, current_time и current_timestamp, так и множество нестандартных функций. Функции PostgreSQL, предназначенные для работы с датой и временем, перечислены в табл. 5.11.

Таблица 5.11. Функции для работы с датой и временем



Функция Описание

current date

Возвращает текущую дату в виде значения типа date

current time

Возвращает текущее время в виде значения типа time

current timestamp

Возвращает текущие дату и время в виде значения типа timestamp

date_part(s. t)

Выделяет из значения типа timestamp компонент даты или времени, определяемый строкой s

date_part(s. i)

Выделяет из значения типа interval компонент даты или времени, определяемый строкой s

date trunc(s, t)

Возвращает значение типа timestamp, усеченное до точности s

extract (k FROM t)

Выделяет из значения типа timestamp компонент даты или времени, определяемый ключевым словом k

extracttk FROM i)

Выделяет из значения типа interval компонент даты или времени, определяемый ключевым словом k

isfinite(t)

Возвращает true, если значение типа timestamp соответствует конечной величине (не invalid и не infinity)

isfinite(i)

Возвращает true, если значение типа interval соответствует конечной величине (не infinity)

now()

Возвращает текущие дату и время в виде значения типа timestamp. Эквивалент константы now

timeofdayO

Возвращает текущие дату и время в виде значения типа text

Ниже приведены более подробные описания всех функций, перечисленных в таблице. Обратите внимание на отсутствие круглых скобок в определениях функций current_date, current_time и current_timestamp — это сделано для сохранения совместимости со стандартом SQL92.

current_date

Синтаксис:

current_date

Функция current_date вызывается без аргументов и возвращает текущую дату в виде значения типа date. Результат эквивалентен преобразованию специальной константы now к типу date.

Пример

booktown=# SELECT current_date,

booktown-# 'now'::date AS date;

date date

2001-08-31 | 2001-08-31

(1 row)

current_time

Синтаксис:

current_time

Функция current_time вызывается без аргументов и возвращает текущее время в виде значения типа time. Результат эквивалентен преобразованию специальной константы now к типу time.

Пример

booktown=# SELECT current_time,

booktown-# 'now'::time AS time;

time | time

11:36:52 | 11:36:52

(1 row)

current_timestamp

Синтаксис:

current_timestamp

Функция current_timestamp вызывается без аргументов и возвращает текущее время в виде значения типа timestamp. Результат эквивалентен преобразованию специальной константы now к типу timestamp или вызову функции now().

Пример

booktown=# SELECT current_timestamp.

booktown-# now() AS timestamp;

timestamp | timestamp

2001-08-31 11:39:42-07 2001-08-31 11:39:42-07

(1 row)

date_part()

Синтаксис:

date_part(s. t) date_part(s. i)

Функция date_part() получает два аргумента. Первый аргумент s относится к типу text, а второй, t или I, — к типу timestamp или interval соответственно. Функция выделяет во втором аргументе компонент, определяемый строкой s, и возвращает его в виде значения типа doubl e preci si on.

Чтобы лучше понять, как работает функция date_part(), представьте, что значение типа timestamp или interval делится на компоненты — часы, минуты и т. д. Эти компоненты (и соответственно допустимые значения аргумента s) перечислены в табл. 5.12. Помните, что некоторые значения относятся только к типу tlmestamp и не поддерживаются для типа Interval.

Таблица 5.12. Компоненты типов timestamp и interval

Компонент Описание

century

Год, разделенный на 100 (не совпадает с текущим веком!)

day

День месяца (от 1 до 31) для типа timestamp, продолжительность интервала в днях для типа interval

decade

Год, разделенный на 10

dow

День недели (от 0 до 6), начиная с воскресенья. Для типа interval не поддерживается

doy

День года (от 1 до 366). Для типа interval не поддерживается

epoch

Количество секунд от начала эпохи (1 января 1970 г.) для типа timestamp, продолжительность интервала в секундах для типа interval

hour

Час в значении типа timestamp

microseconds

Количество миллионных долей в дробной части секунд для значения типа timestamp

millennium

Год, разделенный на 1000 (не совпадает с текущим тысячелетием!)

mi 11 i seconds

Количество тысячных долей в дробной части секунд для значения типа timestamp

minute

Минуты в значении типа timestamp или interval

month

Месяц в значении типа timestamp или остаток от деления продолжительности интервала в месяцах на 12 для типа interval

quarter

Квартал (от 1 до 4) для значений типа timestamp

second

Секунды в значении типа timestamp или interval

week

Номер недели в году для значений типа timestamp. В стандарте ISO-8601 первая неделя года определяется как неделя, в которую входит 4 января

year

Год в значении типа timestamp или interval

Примеры

booktown=# SELECT date_part('minute'.

booktown(# intervalC3 days 4 hours 12 minutes')):

date_part

12

(1 row)

booktown=# SELECT isbn,

booktown-l date_part('year', publication)

booktown-# FROM editions

booktown-# ORDER BY date_part ASC

booktown-# LIMIT 3;

isbn | date_part

0760720002 | 1868

0679803335 | 1922

0694003611 | 1947

(3 rows)

ПРИМЕЧАНИЕ

Аналогом функции date_part() в SQL является функция extract().

date_trunc()

Синтаксис: date_trunc(s. t)

Функция date_trunc () получает два аргумента s и t, относящихся к типам text и timestamp соответственно. Строка s определяет компонент, до которого усекается аргумент t. В данном контексте под усечением понимается удаление всех компонентов, детализация которых превышает заданную.

Допустимые значения аргумента s перечислены в табл. 5.12.

Пример

booktown=# SELECT date_trune('minute', now());

date trunc

2001-08-31 09:59:00-07

(1 row)

booktown=# SELECT date_trunc( 'hour', now());

date trunc

2001-08-31 09:00:00-07 (1 row)

booktown=# SELECT date_trunc('year', now());

date trunc

2001-01-01 00:00:00-08

(1 row)

extract()

Синтаксис:

extract(k FROM t) extract(k FROM 1)

Функция SQL92 extractO представляет собой аналог функции PostgreSQL date_part() со слегка измененным синтаксисом. При перечислении аргументов вместо запятой используется ключевое слово FROM. Аргументы аналогичны аргументам функции date_part(), хотя первый аргумент является ключевым словом SQL, а не строкой и поэтому не заключается в кавычки. Допустимые значения k перечислены в табл. 5.12.

Учтите, что функция extractO является «псевдонимом» функции PostgreSQL date_part () в синтаксисе SQL92, поэтому по умолчанию в выходных данных функция extract() представляется именем date_part.

Примеры

booktown=# SELECT extract(MINUTE FROM

interval('3 days 12 minutes1)): datejpart

12

(1 row)

booktown=# SELECT extractCMONTH FROM now()):

date_part

8

(1 row)

isfinite()

Синтаксис:

isfinite(t) isfinite(i)

Функция 1 sf 1 ni te() получает один аргумент типа timestamp или 1 interval. Она возвращает true, если переданное значение не является бесконечным, созданным при помощи специальной константы Infinity или invalid (используется только для timestamp).

Пример

booktown=# SELECT isfinite('now'::timestamp) AS now_is_finite,

booktown-# isfinite('infinity'::timestamp) AS Infinity,

booktown-# isfiniteC'invalid'::timestamp) AS invalid;

now_is_finite | infinity | invalid

(1 row)

now()

Синтаксис:

now()

Функция now() вызывается без аргументов и возвращает текущую дату и время в виде значения типа timestamp.

Пример

booktown=# SELECT now();

now

2001-08-31 10:31:18-07

(1 row)

timeofday()

Синтаксис: timeofdayO

Функция timeofday() вызывается без аргументов и возвращает текущие время и дату. Она похожа на функцию now(), но возвращает значение типа text. Это делает ее менее удобной, поскольку значение не разделяется на компоненты функциями date_part() и to_char() без предварительного преобразования к другому типу.

Пример

Dooktown=# SELECT timeofday();

timeofday

Fn Aug 31 10:33:00.837338 2001 PDT

(1 row)



Содержание раздела