SQLite Дата и время

SQLite поддерживает следующие пять функций даты и времени:

Нет.ФункцияПример
1date(timestring, modifier, modifier, ...)Возвращает дату в формате YYYY-MM-DD.
2time(timestring, modifier, modifier, ...)Возвращает время в формате HH:MM:SS.
3datetime(timestring, modifier, modifier, ...)Возвращает в формате YYYY-MM-DD HH:MM:SS.
4julianday(timestring, modifier, modifier, ...)Возвращает количество дней, прошедших с полудня 24 ноября 4714 г. до н. э. по гринвичскому времени.
5strftime(format, timestring, modifier, modifier, ...)Возвращает отформатированную дату в соответствии со строкой формата, указанной первым параметром. Описание конкретных форматов см. ниже.

Пять вышеперечисленных функций даты и времени принимают строку времени в качестве аргумента. За строкой времени следует ноль или более модификаторов. Функция strftime() также может принимать строку формата в качестве первого аргумента. Ниже мы подробно объясним различные типы строк времени и модификаторов.

Строки времени

Строка времени может быть в любом из следующих форматов:

Нет.Строка времениПример
1YYYY-MM-DD2010-12-30
2YYYY-MM-DD HH:MM2010-12-30 12:10
3YYYY-MM-DD HH:MM:SS.SSS2010-12-30 12:10:04.100
4MM-DD-YYYY HH:MM12-30-2010 12:10
5HH:MM12:10
6YYYY-MM-DDTHH:MM2010-12-30 12:10
7HH:MM:SS12:10:01
8YYYYMMDD HHMMSS20101230 121001
9now2013-05-07

Вы можете использовать "T" в качестве литерального символа, разделяющего дату и время.

Модификаторы

За строкой времени может следовать ноль или более модификаторов, которые изменят дату и/или время, возвращаемые вышеуказанными пятью функциями. Все вышеуказанные пять функций возвращают время. Модификаторы следует использовать слева направо. Ниже перечислены модификаторы, которые можно использовать в SQLite:

  • NNN дней

  • NNN часов

  • NNN минут

  • NNN.NNNN секунд

  • NNN месяцев

  • NNN лет

  • начало месяца

  • начало года

  • начало дня

  • день недели N

  • unixepoch

  • localtime

  • utc

Форматирование

SQLite предоставляет очень удобную функциюstrftime()для форматирования любой даты и времени. Вы можете использовать следующие подстановки для форматирования даты и времени:

ПодстановкаОписание %dДень месяца, 01-31 %fСекунды с дробной частью, SS.SSS %HЧас, 00-23 %jДень года, 001-366 %JНомер юлианского дня, DDDD.DDDD %mМесяц, 00-12 %MМинута, 00-59 %sСекунды с 1970-01-01 %SСекунда, 00-59 %wДень недели, 0-6 (0 — воскресенье) %WНеделя года, 01-53 %YГод, YYYY %%Символ %

Примеры

Теперь давайте попробуем разные примеры, используя приглашение SQLite. Следующее вычисляет текущую дату:

sqlite> SELECT date('now');
2013-05-07

Следующее вычисляет последний день текущего месяца:

sqlite> SELECT date('now','start of month','+1 month','-1 day');
2013-05-31

Следующее вычисляет дату и время для заданной временной метки UNIX 1092941466:

sqlite> SELECT datetime(1092941466, 'unixepoch');
2004-08-19 18:51:06

Следующее вычисляет дату и время для заданной временной метки UNIX 1092941466 в местном часовом поясе:

sqlite> SELECT datetime(1092941466, 'unixepoch', 'localtime');
2004-08-19 11:51:06

Следующее вычисляет текущую временную метку UNIX:

sqlite> SELECT strftime('%s','now');
1367926057

Следующее вычисляет количество дней с момента подписания «Декларации независимости» США:

sqlite> SELECT julianday('now') - julianday('1776-07-04');
86504.4775830326

Следующее вычисляет количество секунд с определенного момента в 2004 году:

sqlite> SELECT strftime('%s','now') - strftime('%s','2004-01-01 02:34:56');
295001572

Следующее вычисляет дату первого вторника октября текущего года:

sqlite> SELECT date('now','start of year','+9 months','weekday 2');
2013-10-01

Следующее вычисляет время в секундах с начала эпохи UNIX (аналогично strftime('%s','now'), за исключением того, что оно включает дробную часть):

sqlite> SELECT (julianday('now') - 2440587.5)*86400.0;
1367926077.12598

Чтобы преобразовывать значения времени UTC и местного времени, используйте модификаторы utc или localtime при форматировании дат, как показано ниже:

sqlite> SELECT time('12:00', 'localtime');
05:00:00
sqlite>  SELECT time('12:00', 'utc');
19:00:00
Другие расширения