SQL Funções de Data e Hora

O SQLite não tem um tipo especial para datas: ele guarda a data como texto no formato AAAA-MM-DD (como os pedidos da Loja Aurora: '2026-10-14') e oferece funções para ler, calcular e formatar esse texto. Esta página reúne todas elas, com os modificadores e os códigos do strftime, cada um com o resultado real. A explicação passo a passo está nas aulas Datas e Horas e Funções de Data.

As funções

Todas recebem um valor de tempo (uma data, uma data com hora, ou 'now') e, depois dele, zero ou mais modificadores (tabela Modificadores).

No terminal da Ana, com o relógio de verdade. Repare que 'now' e CURRENT_TIMESTAMP estão em UTC, e só o 'localtime' mostra a hora do relógio dela (Brasília, 3 horas a menos):

sqlite> SELECT date('now'), datetime('now'), datetime('now', 'localtime');
2026-10-18|2026-10-18 13:43:19|2026-10-18 10:43:19
sqlite> SELECT CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP;
2026-10-18|13:43:19|2026-10-18 13:43:19

Os formatos de data que o SQLite entende

Modificadores

Os modificadores vêm depois da data, cada um entre aspas, e são aplicados da esquerda para a direita. Os nomes são em inglês e com letras minúsculas.

Combinando modificadores, o último dia do mês: vá para o dia 1, some um mês e volte um dia.

SELECT date('2026-10-14', 'start of month', '+1 month', '-1 day') AS ultimo_dia,
       date('2026-02-10', 'start of month', '+1 month', '-1 day') AS ultimo_de_fevereiro;

Os códigos do strftime

No strftime(formato, data), cada código % do formato é trocado por uma parte da data. O resto do formato (barras, espaços, letras) sai como está. Todos os exemplos usam a quarta-feira 2026-10-14 15:30:45, a não ser quando indicado.

Contas com datas

Quantos dias cada pedido levou para ser entregue. O pedido 86 ainda não foi entregue (entregue_em é NULL), e a conta com NULL dá NULL:

SELECT id, data, entregue_em,
       julianday(entregue_em) - julianday(data) AS dias
FROM pedidos
WHERE id IN (1, 2, 86);

E os pedidos de 2026, mês a mês, a partir de julho:

SELECT strftime('%Y-%m', data) AS mes, count(*) AS pedidos
FROM pedidos
WHERE data >= '2026-07-01'
GROUP BY mes;

A idade de cada cliente numa data (aqui, 18/10/2026): a diferença dos anos, menos 1 se o aniversário ainda não chegou naquele ano. A comparação entre parênteses vale 1 (verdadeiro) ou 0 (falso):

SELECT nome, nascimento,
       (strftime('%Y', '2026-10-18') - strftime('%Y', nascimento))
       - (strftime('%m-%d', '2026-10-18') < strftime('%m-%d', nascimento)) AS idade
FROM clientes
WHERE id <= 3;

No editor do guia

O editor roda o SQLite dentro do seu navegador. Então 'now' e CURRENT_DATE usam o relógio do seu computador, e 'localtime' usa o fuso dele: o resultado muda de leitor para leitor. É por isso que os exemplos desta página usam datas fixas.

Nos outros bancos

Experimente

SELECT data
FROM pedidos
WHERE data LIKE '2025%';

SELECT strftime('%m', data) AS mes, count(*) AS pedidos
FROM pedidos
WHERE strftime('%Y', data) = '2025'
GROUP BY mes;

Resumo

• No SQLite, datas são texto AAAA-MM-DD (com zeros). Assim, ordenar e comparar como texto funciona.
• date, time, datetime leem e normalizam; julianday e unixepoch viram números para fazer contas; strftime formata; timediff mostra a diferença.
• Modificadores, da esquerda para a direita: '+7 days', '-1 month', 'start of month', 'weekday 0', 'localtime'…
• Tudo é em UTC, a não ser com 'localtime'.
• Data ou modificador errado dá NULL, sem erro: '14/10/2026' e '+1 dia' não funcionam.
• strftime devolve texto: compare com '2025', entre aspas.