Исполняемые доки SQLite: Дата и время

Q: Есть ли в SQLite тип DATE или DATETIME?

Нет, отдельного типа для даты в SQLite не предусмотрено. Дату можно хранить как TEXT в формате ISO 8601 ('2026-04-23 10:15:00'), как Unix timestamp в INTEGER или как юлианский день в REAL. Встроенные функции работы с датой принимают все три формата, а возвращают по умолчанию текст в ISO 8601.

Q: Как получить текущую дату и время в SQLite?

Используйте date('now') для текущей даты, time('now') для времени, datetime('now') для даты и времени вместе, а strftime('%s', 'now') вернёт Unix timestamp. По умолчанию все эти функции отдают UTC — чтобы получить локальное время, добавьте модификатор 'localtime': datetime('now', 'localtime').

Q: Как прибавить дни или месяцы к дате в SQLite?

Передайте в функцию строку-модификатор: date('2026-04-23', '+7 days'), date('now', '-1 month'), datetime('now', '+2 hours', '+30 minutes'). Модификаторы применяются последовательно, в порядке передачи. Поддерживаются единицы days, hours, minutes, seconds, months и years.

Q: Как посчитать разницу между двумя датами?

Для разницы в днях используйте julianday(end) - julianday(start) — юлианские дни хранятся как REAL, поэтому в результате будут и дробные дни. Для секунд проще вычесть Unix timestamp: strftime('%s', end) - strftime('%s', start). Аналога DATEDIFF в SQLite нет, но этих двух приёмов хватает практически на все случаи.

В SQLite по сути нет типа даты

Это сбивает с толку всех, кто пришёл из Postgres или MySQL. В SQLite всего пять классов хранения — NULL, INTEGER, REAL, TEXT, BLOB, и больше ничего. Никаких DATE, DATETIME или TIMESTAMP. Да, в CREATE TABLE можно написать created_at DATETIME, и SQLite это проглотит, но под капотом значение всё равно ляжет как обычный текст или число.

Зато SQLite даёт набор функций, которые понимают три устоявшихся формата хранения даты:

Текст в формате ISO 8601 — '2026-04-23', '2026-04-23 10:15:00', '2026-04-23T10:15:00.123Z'.
Unix timestamp — количество секунд с 1970-01-01 UTC в виде целого числа.
Юлианский день — дробное число дней с 4714 года до н. э., хранится как вещественное.

Выберите один формат и придерживайтесь его. ISO 8601 — самый читаемый вариант, к тому же такие строки корректно сортируются как обычный текст. Именно поэтому он считается форматом по умолчанию.

SELECT date('now'),
       datetime('now'),
       strftime('%s', 'now'),
       julianday('now');

Четыре способа спросить «прямо сейчас» — текстовая дата, текстовая дата-время, секунды Unix и юлианский день. Все они описывают один и тот же момент времени.

Пять функций для работы с датами

В SQLite есть пять встроенных функций, которые покрывают практически любые задачи с датами:

date(time, ...) — возвращает дату в формате YYYY-MM-DD.
time(time, ...) — возвращает время в формате HH:MM:SS.
datetime(time, ...) — возвращает YYYY-MM-DD HH:MM:SS.
julianday(time, ...) — возвращает вещественное число (удобно для вычисления разницы между датами).
strftime(format, time, ...) — возвращает строку в произвольном формате.

Первым аргументом каждая функция принимает значение времени, а дальше можно передать сколько угодно строк-модификаторов.

SELECT date('2026-04-23 10:15:00')          AS just_date,
       time('2026-04-23 10:15:00')          AS just_time,
       datetime(1745402100, 'unixepoch')    AS from_unix,
       julianday('2026-04-23')              AS julian;

Обрати внимание на 'unixepoch' — это модификатор, которым мы говорим функциям работы с датой, что на входе у нас Unix-таймстамп, а не юлианский день. Без него SQLite будет считать число юлианским днём.

strftime в SQLite: свой формат даты

strftime — это рабочая лошадка. %-спецификаторы те же, что в C или Python:

SELECT strftime('%Y-%m-%d',           'now') AS iso_date,
       strftime('%d/%m/%Y',           'now') AS european,
       strftime('%H:%M',              'now') AS hours_minutes,
       strftime('%Y-%m-%dT%H:%M:%fZ', 'now') AS iso_with_ms,
       strftime('%w',                 'now') AS day_of_week,
       strftime('%j',                 'now') AS day_of_year;

Коды форматирования, которые понадобятся чаще всего:

%Y — год из четырёх цифр.
%m — месяц (01–12).
%d — день месяца (01–31).
%H, %M, %S — часы, минуты, секунды.
%w — день недели (0 = воскресенье).
%j — день года (001–366).
%s — Unix-время (timestamp).
%f — доли секунды (SS.SSS).

Через strftime же удобно вытаскивать отдельные части даты — в SQLite нет отдельных функций вроде EXTRACT или YEAR(). Просто форматируете дату до нужного куска, а если требуется число — приводите тип:

SELECT strftime('%Y', '2026-04-23') AS year_text,
       CAST(strftime('%Y', '2026-04-23') AS INTEGER) AS year_num,
       CAST(strftime('%m', '2026-04-23') AS INTEGER) AS month_num;

strftime всегда возвращает текст, поэтому если нужно посчитать или сравнить как число — оборачивайте вызов в CAST(... AS INTEGER).

Модификаторы: арифметика дат без операторов

Именно эта возможность делает работу с датами в SQLite по-настоящему удобной. После аргумента со временем можно передать сколько угодно строк-модификаторов, и они применятся по порядку:

SELECT date('2026-04-23', '+7 days')              AS week_later,
       date('2026-04-23', '-1 month')             AS month_earlier,
       datetime('now', '+2 hours', '+30 minutes') AS in_two_thirty,
       date('now', 'start of month')              AS first_of_month,
       date('now', 'start of month', '+1 month', '-1 day') AS last_of_month,
       date('now', 'weekday 0')                   AS next_sunday;

Модификаторы, которые пригодятся постоянно:

'+N days', '-N days' и то же самое для hours, minutes, seconds, months, years.
'start of day', 'start of month', 'start of year' — округление вниз до соответствующей границы.
'weekday N' — переход к ближайшему указанному дню недели (0 = воскресенье).
'localtime' и 'utc' — перевод между часовыми поясами.

Запомните трюк «последний день месяца»: начало месяца, плюс один месяц, минус один день. Отдельной функции LAST_DAY в SQLite нет, но цепочка модификаторов решает задачу ничуть не хуже.

UTC и локальное время

'now' всегда возвращает время в UTC. Если нужно локальное — это надо указать явно:

SELECT datetime('now')              AS utc_now,
       datetime('now', 'localtime') AS local_now,
       datetime('2026-04-23 10:00:00', 'utc') AS treated_as_local_then_utc;

Модификатор 'localtime' переводит значение UTC в локальный часовой пояс системы. Модификатор 'utc' работает наоборот — принимает входное значение как локальное время и переводит его в UTC.

Хорошее правило: храните всё в UTC, а в локальное время переводите только при выводе. Если в хранилище смешаны часовые пояса, баги обязательно вылезут — причём дважды в год, когда переводят стрелки на летнее/зимнее время.

Сравнение дат и выборка по диапазону в SQLite

Если даты хранятся как текст в формате ISO 8601, то сравнение и BETWEEN работают сами собой — ISO 8601 сортируется лексикографически точно так же, как и хронологически. Собственно, ради этого его и сделали форматом по умолчанию.

CREATE TABLE orders (
    id         INTEGER PRIMARY KEY,
    customer   TEXT,
    placed_at  TEXT NOT NULL  -- ISO 8601
);

INSERT INTO orders (customer, placed_at) VALUES
    ('Ada',   '2026-04-01 09:30:00'),
    ('Boris', '2026-04-15 14:00:00'),
    ('Carla', '2026-04-23 11:45:00'),
    ('Dmitri','2026-05-02 08:15:00');

SELECT customer, placed_at
FROM orders
WHERE placed_at >= '2026-04-01'
  AND placed_at <  '2026-05-01'
ORDER BY placed_at;

Полуоткрытый интервал (>= начало, < конец) — отличная привычка: он сразу снимает вопрос «а полночь 30-го числа попала в выборку или нет?».

Для «последних 7 дней» пусть границу считает сам SQLite:

CREATE TABLE orders (
    id         INTEGER PRIMARY KEY,
    customer   TEXT,
    placed_at  TEXT NOT NULL
);

INSERT INTO orders (customer, placed_at) VALUES
    ('Ada',   datetime('now', '-2 days')),
    ('Boris', datetime('now', '-10 days')),
    ('Carla', datetime('now', '-1 day')),
    ('Dmitri',datetime('now', '-30 days'));

SELECT customer, placed_at
FROM orders
WHERE placed_at >= datetime('now', '-7 days')
ORDER BY placed_at DESC;

Разница между датами в SQLite

В SQLite нет функции DATEDIFF. Зато есть два приёма, которых хватает на все случаи жизни:

SELECT julianday('2026-04-23') - julianday('2026-04-01')           AS days_between,
       (julianday('2026-04-23 18:00') - julianday('2026-04-23 09:00')) * 24 AS hours_between,
       strftime('%s', '2026-04-23 18:00') - strftime('%s', '2026-04-23 09:00') AS seconds_between;

Разница, которую возвращает julianday(), измеряется в днях (с дробной частью), поэтому умножение на 24 даёт часы, а на 1440 — минуты. Разница strftime('%s', ...) считается в секундах — удобно, когда нужно целое число.

CAST(... AS INTEGER) отбрасывает дробную часть дней, если нужно получить количество полных суток:

CREATE TABLE orders (
    id         INTEGER PRIMARY KEY,
    customer   TEXT,
    placed_at  TEXT NOT NULL
);

INSERT INTO orders (customer, placed_at) VALUES
    ('Ada',   datetime('now', '-2 days')),
    ('Boris', datetime('now', '-10 days')),
    ('Carla', datetime('now', '-1 day')),
    ('Dmitri',datetime('now', '-30 days'));

SELECT customer,
       CAST(julianday('now') - julianday(placed_at) AS INTEGER) AS days_ago
FROM orders
ORDER BY days_ago;

Хранение даты в SQLite: выбираем один формат и не отступаем

Есть три разумных варианта — в порядке того, как часто их стоит выбирать:

Текст в формате ISO 8601 (TEXT). Читается в дампах глазами, корректно сортируется, дружит со всеми функциями работы с датой. Вариант по умолчанию.
Unix-время в секундах (INTEGER). Компактно, сравнения работают быстро, никакой путаницы с часовыми поясами. Хороший выбор, когда строк миллионы. Чтобы прочитать значение обратно, понадобится datetime(col, 'unixepoch').
Юлианский день (REAL). Редко себя оправдывает — разве что вы плотно занимаетесь арифметикой дат и хотите субсекундную точность в одном столбце.

Чего делать точно не стоит — так это мешать форматы в одном столбце. Функции работы с датой молча проглотят и то, и другое, а вот индексы, сортировка и сравнения начнут выдавать ерунду.

-- Значения по умолчанию, автоматически подставляемые при вставке:
CREATE TABLE events (
    id          INTEGER PRIMARY KEY,
    name        TEXT NOT NULL,
    happened_at TEXT NOT NULL DEFAULT (datetime('now'))
);

INSERT INTO events (name) VALUES ('регистрация'), ('вход');

SELECT name, happened_at FROM events;

DEFAULT (datetime('now')) — это аналог DEFAULT CURRENT_TIMESTAMP в SQLite: каждая новая строка автоматически получает текущее время в UTC, и никакого кода на стороне приложения для этого не нужно.

Группировка по временным интервалам

Функция strftime особенно удобна, когда нужно разложить строки по месяцам, неделям или часам:

CREATE TABLE orders (
    id         INTEGER PRIMARY KEY,
    customer   TEXT,
    placed_at  TEXT NOT NULL
);

INSERT INTO orders (customer, placed_at) VALUES
    ('Ada',   '2026-04-01 09:30:00'),
    ('Boris', '2026-04-15 14:00:00'),
    ('Carla', '2026-04-23 11:45:00'),
    ('Dmitri','2026-05-02 08:15:00'),
    ('Ezra',  '2026-05-20 17:00:00');

SELECT strftime('%Y-%m', placed_at) AS month,
       COUNT(*)                     AS order_count
FROM orders
GROUP BY month
ORDER BY month;

Та же логика подойдёт и для других задач: «заказы по часам», «регистрации по дням недели», «события по минутам» — берём формат, который даёт нужную детализацию, группируем по нему и считаем агрегат.

Дальше: агрегатные функции

Раз уж зашла речь о группировке — COUNT(*) это самая простая из агрегатных функций SQLite. Дальше разберём весь набор: SUM, AVG, MIN, MAX — и посмотрим, как они сворачивают множество строк в одно итоговое значение.

Часто задаваемые вопросы

Есть ли в SQLite тип DATE или DATETIME?

Нет, отдельного типа для даты в SQLite не предусмотрено. Дату можно хранить как TEXT в формате ISO 8601 ('2026-04-23 10:15:00'), как Unix timestamp в INTEGER или как юлианский день в REAL. Встроенные функции работы с датой принимают все три формата, а возвращают по умолчанию текст в ISO 8601.

Как получить текущую дату и время в SQLite?

Используйте date('now') для текущей даты, time('now') для времени, datetime('now') для даты и времени вместе, а strftime('%s', 'now') вернёт Unix timestamp. По умолчанию все эти функции отдают UTC — чтобы получить локальное время, добавьте модификатор 'localtime': datetime('now', 'localtime').

Как прибавить дни или месяцы к дате в SQLite?

Передайте в функцию строку-модификатор: date('2026-04-23', '+7 days'), date('now', '-1 month'), datetime('now', '+2 hours', '+30 minutes'). Модификаторы применяются последовательно, в порядке передачи. Поддерживаются единицы days, hours, minutes, seconds, months и years.

Как посчитать разницу между двумя датами?

Для разницы в днях используйте julianday(end) - julianday(start) — юлианские дни хранятся как REAL, поэтому в результате будут и дробные дни. Для секунд проще вычесть Unix timestamp: strftime('%s', end) - strftime('%s', start). Аналога DATEDIFF в SQLite нет, но этих двух приёмов хватает практически на все случаи.

Связанные концепции

Дата и время в SQLite: strftime, date(), datetime()