Руководство по SQL. Функции даты.

Ниже приведён список важных функций, которые относятся к дате и времени. Все данные функции доступны для работы с помощью SQL.

Примеры, приведённые ниже предназначены для RDBMS MySQL.

Name Description
ADDDATE() Добавляет дату
ADDTIME() Добавляет время
CONVERT_TZ() Конвертирует одну временную зону в другую.
CURDATE() Возвращает текущую дату.
CURRENT_DATE(), CURRENT_DATE То же самое, что и CURDATE.
CURTIME() Возвращает текущее время
NOW() Возвращает текущие дату и время.
CURRENT_TIME(), CURRENT_TIME То же самое, что и NOW()
DATE_ADD() Добавляет две даты
DATE_FORMAT() Определяет формат даты
DATE_SUB() Разбивает две даты
DATE() Возвращает только дату (число, месяц, год) из даты.
DATEDIFF() Разделяет две даты
DAY() То же самое, что и DAYOFMONTH()
DAYNAME() Возвращает имя дня недели.
DAYOFMONTH() Возвращает день месяца
DAYOFWEEK() Возвращает индекс аргумента дня недели
DAYOFYEAR() Возвращает номер дня в году (1 – 366)
EXTRACT Выдаёт часть даты
FROM_DAYS() Конвертирует номер дня в дату.
FROM_UNIXTIME() Форматирует дату в дата/время для UNIX систем.
HOUR() Возвращает часы
LAST_DAY Возвращает крайний день месяца.
LOCALTIME(), LOCALTIME То же самое, что и NOW()
LOCALTIMESTAMP, LOCALTIMESTAMP() То же самое, что и NOW()
MAKEDATE() Создаёт дату из года и дня в году
MAKETIME Создаёт время
MICROSECOND() Возвращает микросекунды
MINUTE() Возвращает только минуты
MONTH() Возвращает только месяц
MONTHNAME() Возвращает имя месяца
CURRENT_TIMESTAMP(), CURRENT_TIMESTAMP Синоним для NOW()
PERIOD_ADD() Добавляет период для в месяце-году.
PERIOD_DIFF() Возвращает количество месяцев в периоде.
QUARTER() Возвращает квартал
SEC_TO_TIME() Конвертирует секунды в формат ‘ЧЧ:ММ:СС’
SECOND() Возвращает секунды (0 – 59)
STR_TO_DATE() Конвертирует строку в дату
SUBDATE() То же самое, что и DATE_SUB() Требует три аргумента
SUBTIME() Разделяет время
SYSDATE() Возвращает системное время
TIME_FORMAT() Определяет формат времени
TIME_TO_SEC() Конвертирует время в секунды
TIME() Возвращает время.
TIMEDIFF() Отделяет время
TIMESTAMP() Возвращает текущие дату и время.
TIMESTAMPADD() Добавляет период дата/время
IMESTAMPDIFF() Отделяет интервал из дата/время
TO_DAYS() Конвертирует дату в дни
UNIX_TIMESTAMP() Возвращает дату/время для UNIX систем
UTC_DATE() Возвращает дату UTC
UTC_TIME() Возвращает время UTC
UTC_TIMESTAMP() Возвращает дату/время UTC
WEEK() Возвращает номер недели
WEEKDAY() Возвращает индекс дня недели
WEEKOFYEAR() Возвращает номер недели в году (1 – 53)
YEAR() Возвращает год
YEARWEEK() Возвращает год и неделю

Примеры

Добавление даты (ADDDATE)


mysql> SELECT DATE_ADD('2016-06-30', INTERVAL 30 DAY);
+-----------------------------------------+
| DATE_ADD('2016-06-30', INTERVAL 30 DAY) |
+-----------------------------------------+
| 2016-07-30                              |
+-----------------------------------------+
1 row in set (0.00 sec)

Добавление времени (ADDTIME)


mysql> SELECT ADDTIME('2016-06-06 23:59:59', '2 2:2:2.0');
+---------------------------------------------+
| ADDTIME('2016-06-06 23:59:59', '2 2:2:2.0') |
+---------------------------------------------+
| 2016-06-09 02:02:01                         |
+---------------------------------------------+
1 row in set (0.00 sec)

Конвертация временной зоны (CONVERT_TZ)


mysql> SELECT CONVERT_TZ('2004-01-01 12:00:00','+00:00','+03:00');
+-----------------------------------------------------+
| CONVERT_TZ('2004-01-01 12:00:00','+00:00','+03:00') |
+-----------------------------------------------------+
| 2004-01-01 15:00:00                                 |
+-----------------------------------------------------+
1 row in set (0.00 sec)

Текущая дата (CURDATE())


mysql> SELECT CURDATE();
+------------+
| CURDATE()  |
+------------+
| 2016-06-04 |
+------------+
1 row in set (0.00 sec)

Текущее время (CURTIME())


mysql> SELECT CURTIME();
+-----------+
| CURTIME() |
+-----------+
| 14:19:55  |
+-----------+
1 row in set (0.00 sec)

Дата (DATE)


mysql> SELECT DATE('2016-06-04 15:00:00');
+-----------------------------+
| DATE('2016-06-04 15:00:00') |
+-----------------------------+
| 2016-06-04                  |
+-----------------------------+
1 row in set (0.00 sec)

Разница во времени (DATEDIFF())


mysql> SELECT DATEDIFF ('2016-06-06 00:00:00', '1988-10-28 12:00:00');
+---------------------------------------------------------+
| DATEDIFF ('2016-06-06 00:00:00', '1988-10-28 12:00:00') |
+---------------------------------------------------------+
|                                                   10083 |
+---------------------------------------------------------+
1 row in set (0.00 sec)

Добавление даты (DATEADD(), DATE_SUB())
Данные функции обеспечивают арифметику дат. Мы можем добавить или отнять определённый интервал времени от определённой даты.

Ниже приведена таблица, в которой указаны возможные аргументы для интервалов:

Значение Ожидаемый формат
MICROSECOND Микросекунды
SECOND Секунды
MINUTE Минуты
HOUR Часы
DAY Дни
WEEK Недели
MONTH Месяцы
QUARTER Кварталы
YEAR Годы
SECOND_MICROSECOND ‘Секунды.Микросекунды’
MINUTE_MICROSECOND Минуты.Микросекунды’
MINUTE_SECOND ‘Минуты.Секунды’
HOUR_MICROSECOND ‘Часы.Микросекунды’
HOUR_SECOND ‘Часы.Секунды.Микросекунды’
HOUR_MINUTE ‘Часы.Минуты’
DAY_MICROSECOND ‘Дни.Микросекунды’
DAY_SECOND Дни.Часы.Минуты.Секунды
DAY_MINUTE Дни.Часы.Минуты
DAY_HOUR Дни.Часы
YEAR_MONTH Года.Месяцы 

mysql> SELECT DATE_ADD('2016-06-04 20:00:00', INTERVAL '1:1' DAY_HOUR);
+----------------------------------------------------------+
| DATE_ADD('2016-06-04 20:00:00', INTERVAL '1:1' DAY_HOUR) |
+----------------------------------------------------------+
| 2016-06-05 21:00:00                                      |
+----------------------------------------------------------+
1 row in set (0.00 sec)

Формат даты
Формат даты определяется с помощью специальных символов.
Список таких символов приведён в таблице, которая находится ниже:

Спецификатор Описание
%a Сокращённое имя дня недели
%b Сокращённое имя месяца
%c Номер месяца
%D День месяца с английским суффиксом
%d Номер дня в месяце (00 … 31)
%e Номер дня в месяце (0 … 31)
%f Микросекунды (000000 … 999999)
%H Часы (00 … 23)
%h Часы (01 … 12)
%I Часы (01 … 12)
%i Минуты (00 … 59)
%j Дни года (001 … 366)
%k Часы (00 … 23)
%l Часы (1 … 12)
%M Имя месяца
%m Номер месяца
%p AM или PM
%r Время с использованием AM или PM
%S Секунды (00 … 59)
%s Секунды (00 … 59)
%T Время (ЧЧ:ММ:СС)
%U Неделя (00 … 53). Первый день недели – Воскресенье
%u Неделя (00 … 53). Первый день недели – Понедельник
%V Неделя (00 … 53). Первый день недели – Воскресенье. Используется с %X
%v Неделя (00 … 53). Первый день недели – Понедельник. Используется с %x
%W День недели
%w День недели (0 – Воскресенье … 6 – Суббота)
%X Год для недели. Воскресенье – первый день недели. Используется с %V
%x Год для недели. Понедельник – первый день недели. Используется с %v
%Y Год  (YYYY)
%y Год (YY)
%% Символ .%.
%x То же самое для любых элементов, указанных выше 

mysql> SELECT DATE_FORMAT ('2016-06-04 22:00:00', '%W %M %Y');
+-------------------------------------------------+
| DATE_FORMAT ('2016-06-04 22:00:00', '%W %M %Y') |
+-------------------------------------------------+
| Saturday June 2016                              |
+-------------------------------------------------+
1 row in set (0.00 sec)

Имя дня (DAYNAME())


mysql> SELECT DAYNAME('1988-10-28');
+-----------------------+
| DAYNAME('1988-10-28') |
+-----------------------+
| Friday                |
+-----------------------+
1 row in set (0.00 sec)

День месяца (DAYOFMONTH())


mysql> SELECT DAYOFMONTH('1988-10-28');
+--------------------------+
| DAYOFMONTH('1988-10-28') |
+--------------------------+
|                       28 |
+--------------------------+
1 row in set (0.01 sec)

День недели (DAYOFWEEK())


mysql> SELECT DAYOFWEEK('1988-10-28');
+-------------------------+
| DAYOFWEEK('1988-10-28') |
+-------------------------+
|                       6 |
+-------------------------+
1 row in set (0.00 sec)

День в году (DAYOFYEAR())


mysql> SELECT DAYOFYEAR('1988-10-28');
+-------------------------+
| DAYOFYEAR('1988-10-28') |
+-------------------------+
|                     302 |
+-------------------------+
1 row in set (0.00 sec)

Неделя (WEEK())


mysql> SELECT WEEK('1988-10-28');
+--------------------+
| WEEK('1988-10-28') |
+--------------------+
|                 43 |
+--------------------+
1 row in set (0.00 sec)

На этом мы заканчиваем изучение функций даты в языке SQL.
В следующей статье мы рассмотрим временные таблицы.