SQLite Дата и время
SQLite поддерживает следующие пять функций даты и времени:
| Нет. | Функция | Пример |
|---|---|---|
| 1 | date(timestring, modifier, modifier, ...) | Возвращает дату в формате YYYY-MM-DD. |
| 2 | time(timestring, modifier, modifier, ...) | Возвращает время в формате HH:MM:SS. |
| 3 | datetime(timestring, modifier, modifier, ...) | Возвращает в формате YYYY-MM-DD HH:MM:SS. |
| 4 | julianday(timestring, modifier, modifier, ...) | Возвращает количество дней, прошедших с полудня 24 ноября 4714 г. до н. э. по гринвичскому времени. |
| 5 | strftime(format, timestring, modifier, modifier, ...) | Возвращает отформатированную дату в соответствии со строкой формата, указанной первым параметром. Описание конкретных форматов см. ниже. |
Пять вышеперечисленных функций даты и времени принимают строку времени в качестве аргумента. За строкой времени следует ноль или более модификаторов. Функция strftime() также может принимать строку формата в качестве первого аргумента. Ниже мы подробно объясним различные типы строк времени и модификаторов.
Строки времени
Строка времени может быть в любом из следующих форматов:
| Нет. | Строка времени | Пример |
|---|---|---|
| 1 | YYYY-MM-DD | 2010-12-30 |
| 2 | YYYY-MM-DD HH:MM | 2010-12-30 12:10 |
| 3 | YYYY-MM-DD HH:MM:SS.SSS | 2010-12-30 12:10:04.100 |
| 4 | MM-DD-YYYY HH:MM | 12-30-2010 12:10 |
| 5 | HH:MM | 12:10 |
| 6 | YYYY-MM-DDTHH:MM | 2010-12-30 12:10 |
| 7 | HH:MM:SS | 12:10:01 |
| 8 | YYYYMMDD HHMMSS | 20101230 121001 |
| 9 | now | 2013-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
Другие расширения