SQL Funções de Data

Na aula anterior, Datas e Horas, você viu que o SQLite guarda datas como texto, no formato '2026-10-14'. Agora a Ana quer trabalhar com essas datas: contar os pedidos de cada ano e de cada mês, descobrir em que dia da semana a loja vende mais, calcular o prazo de entrega ("7 dias depois do pedido"), achar o último dia do mês e mostrar a data no formato brasileiro. Para isso o SQLite tem seis funções de data e um jeito esperto de fazer contas com elas: os modificadores.

Os exemplos rodam de verdade no seu navegador, num SQLite com o banco da Loja Aurora. Todos usam datas fixas (as dos pedidos, ou '2026-10-14', o dia do último pedido da loja), para que o resultado seja o mesmo hoje e daqui a um ano. Com 'now' no lugar, cada função funciona igual, mas com a data de hoje.

A ideia: a calculadora de datas

Pense no calendário de parede da loja. Com ele, a Ana responde "que dia cai 7 dias depois de 14 de outubro?" contando os quadradinhos, "que dia da semana é dia 14?" olhando o topo da coluna, e "qual o último dia de outubro?" olhando o fim do mês. As funções de data são esse calendário dentro do SQL. Todas funcionam do mesmo jeito:

função( data , modificador , modificador , … )

1. Você entrega uma data (texto ISO, como '2026-10-14', ou um número).
2. Opcionalmente, um ou mais modificadores, que andam no calendário: '+7 days', 'start of month'… Eles são aplicados da esquerda para a direita.
3. A função decide em que formato a resposta sai: só a data, só a hora, os dois, um número…

1. As seis funções

SELECT date('2026-10-14 16:45:10')      AS f_date,
       time('2026-10-14 16:45:10')      AS f_time,
       datetime('2026-10-14')           AS f_datetime,
       julianday('2026-10-14')          AS f_julianday,
       unixepoch('2026-10-14 16:45:10') AS f_unixepoch;

Dia juliano e tempo Unix foram apresentados em Datas e Horas. As quatro primeiras funções também conferem a data: se não entendem o texto, devolvem NULL. E NULL entra, NULL sai: date(NULL) é NULL.

2. strftime: tirar pedaços da data

strftime vem do inglês string format time, "formatar o tempo como texto". O primeiro argumento é um molde, com códigos que começam por %; cada código é trocado por um pedaço da data:

SELECT strftime('%Y', '2026-10-14')        AS ano,
       strftime('%m', '2026-10-14')        AS mes,
       strftime('%d', '2026-10-14')        AS dia,
       strftime('%w', '2026-10-14')        AS dia_semana,
       strftime('%j', '2026-10-14')        AS dia_do_ano,
       strftime('%d/%m/%Y', '2026-10-14')  AS data_br;

'%Y'

O ano com 4 dígitos (Year): 2026.

'%m'

O mês, 01 a 12 (month, com m minúsculo): 10.

'%d'

O dia do mês, 01 a 31 (day): 14.

'%w'

O dia da semana (weekday), de 0 = domingo a 6 = sábado. 14/10/2026 é uma quarta-feira: 3.

'%j'

O dia do ano, 001 a 366: 14 de outubro é o dia 287.

'%d/%m/%Y'

Vários códigos e texto comum juntos: o que não é código (as barras) é copiado como está. Assim sai a data no formato brasileiro.

Os códigos mais usados

Na verdade, as outras funções são atalhos do strftime: date(x) é o mesmo que strftime('%Y-%m-%d', x), e time(x), o mesmo que strftime('%H:%M:%S', x).

Agrupar por ano e por mês

Aqui o strftime brilha. Junto com o GROUP BY, ele responde "quantos pedidos por ano?":

SELECT strftime('%Y', data) AS ano,
       COUNT(*) AS pedidos
FROM pedidos
GROUP BY ano;

32 pedidos em 2024, 32 em 2025 e 26 em 2026 (até outubro). Para agrupar por mês, cuidado: strftime('%m', data) sozinho juntaria janeiro de 2024, de 2025 e de 2026 no mesmo grupo. Use ano e mês juntos, '%Y-%m':

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

O segundo semestre de 2025, mês a mês. Dezembro foi o mais movimentado, com 4 pedidos.

SELECT strftime('%Y', data) AS ano,
       COUNT(*) AS pedidos
FROM pedidos
GROUP BY ano;

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

O dia da semana

O %w dá um número; com um CASE, ele vira o nome do dia:

SELECT id, data,
       CASE strftime('%w', data)
         WHEN '0' THEN 'domingo'
         WHEN '1' THEN 'segunda'
         WHEN '2' THEN 'terça'
         WHEN '3' THEN 'quarta'
         WHEN '4' THEN 'quinta'
         WHEN '5' THEN 'sexta'
         ELSE 'sábado'
       END AS dia_semana
FROM pedidos
WHERE id >= 86;

Repare nas aspas em WHEN '0': o strftime devolve texto, então a comparação é com o texto '0'. Isso importa muito, e você vai ver por quê em Quando dá errado. E em que dia da semana a loja mais vende?

SELECT strftime('%w', data) AS dia_semana,
       COUNT(*) AS pedidos
FROM pedidos
GROUP BY dia_semana
ORDER BY pedidos DESC;

Terça-feira (2), com 23 pedidos. Domingo (0) teve só 1.

3. Modificadores: andar no calendário

Depois da data, as funções aceitam modificadores: textos que somam, subtraem ou "pulam" para um ponto do calendário.

SELECT date('2026-10-14', '+7 days')        AS mais_7_dias,
       date('2026-10-14', '-1 month')       AS menos_1_mes,
       date('2026-10-14', '+1 year')        AS mais_1_ano,
       date('2026-10-14', 'start of month') AS inicio_do_mes,
       date('2026-10-14', 'start of year')  AS inicio_do_ano,
       date('2026-10-14', 'weekday 0')      AS proximo_domingo;

O número pode vir no singular ou no plural ('+1 day' e '+1 days' funcionam), mas tem de ser em inglês: '+7 dias' devolve NULL.

Vários modificadores em fila

Os modificadores são aplicados da esquerda para a direita, cada um sobre o resultado do anterior. O clássico é o último dia do mês: vá para o dia 1, avance um mês e volte um dia.

SELECT date('2026-10-14', 'start of month', '+1 month', '-1 day') AS fim_de_outubro,
       date('2024-02-10', 'start of month', '+1 month', '-1 day') AS fim_de_fev_2024,
       datetime('2026-10-14 16:45:10', '+2 hours', '+30 minutes') AS duas_horas_e_meia_depois;

1. '2026-10-14' com 'start of month' → 2026-10-01.
2. '+1 month' → 2026-11-01.
3. '-1 day' → 2026-10-31. Em 2024, ano bissexto, fevereiro termina no dia 29, e a conta acerta sozinha.

O prazo de entrega

A Loja Aurora promete entregar em até 7 dias. Com um modificador, cada pedido ganha o seu prazo, e o WHERE acha quem passou dele:

SELECT id, data, entregue_em,
       date(data, '+7 days') AS prazo
FROM pedidos
WHERE entregue_em > date(data, '+7 days')
  AND data >= '2026-01-01';

Em 2026, cinco pedidos chegaram 1 dia depois do prazo. A comparação entregue_em > date(…) funciona porque as duas datas estão em ISO (aula Datas e Horas).

4. Diferenças: quantos dias entre duas datas

Para contar os dias entre duas datas, subtraia os dias julianos:

SELECT id, data, entregue_em,
       julianday(entregue_em) - julianday(data) AS dias
FROM pedidos
WHERE id <= 4;

SELECT ROUND(AVG(julianday(entregue_em) - julianday(data)), 2) AS media_dias
FROM pedidos;

Em média, a loja leva 6 dias para entregar. A AVG (aula AVG()) ignorou sozinha os 5 pedidos ainda não entregues, porque julianday(NULL) é NULL. O resultado é REAL (5.0), porque o dia juliano tem fração. Em segundos, use unixepoch(b) - unixepoch(a), que dá um inteiro.

A idade de um cliente

Idade não é "dias ÷ 365": os anos bissextos atrapalham. O jeito certo é a conta que fazemos de cabeça: o ano de hoje menos o ano de nascimento, menos 1 se o aniversário deste ano ainda não chegou. Com a data fixa '2026-10-14' no lugar de "hoje":

SELECT nome, nascimento,
       strftime('%Y', '2026-10-14') - strftime('%Y', nascimento)
       - (strftime('%m-%d', '2026-10-14') < strftime('%m-%d', nascimento)) AS idade
FROM clientes
WHERE id IN (1, 3, 9, 13, 20);

strftime('%Y', '2026-10-14') - strftime('%Y', nascimento)

A diferença dos anos. Os dois são texto, mas a subtração (-) transforma texto em número sozinha: '2026' - '1985' dá 41.

strftime('%m-%d', …) < strftime('%m-%d', nascimento)

Compara "mês-dia" de hoje com o do aniversário. Se o aniversário ainda não chegou este ano, a comparação é verdadeira, e verdadeiro no SQLite vale 1.

- ( … )

Tira esse 1. O Tiago (5 de outubro) já fez aniversário: 26 anos. A Ana Beatriz (3 de novembro) ainda não: 27, e não 28.

O Antônio Carlos (id 9) não tem data de nascimento: a idade dele é NULL. Num sistema de verdade, troque '2026-10-14' por 'now' (ou date('now', 'localtime')).

5. Formas diferentes de fazer

Várias perguntas de data têm mais de uma resposta certa. Para "pedidos de outubro de 2026":

SELECT COUNT(*) AS por_intervalo FROM pedidos
WHERE data >= '2026-10-01' AND data < '2026-11-01';

SELECT COUNT(*) AS por_strftime FROM pedidos
WHERE strftime('%Y-%m', data) = '2026-10';

SELECT COUNT(*) AS por_start_of_month FROM pedidos
WHERE date(data, 'start of month') = '2026-10-01';

A timediff é nova (chegou no SQLite 3.43) e só existe no SQLite.

Quando dá errado

As funções de data quase nunca dão erro: quando algo está errado, elas devolvem NULL ou um resultado inesperado. Conheça os casos.

SELECT COUNT(*) AS pedidos_2025
FROM pedidos
WHERE strftime('%Y', data) = 2025;

SELECT COUNT(*) AS pedidos_2025
FROM pedidos
WHERE strftime('%Y', data) = 2025;

SELECT COUNT(*) AS pedidos_2025
FROM pedidos
WHERE strftime('%Y', data) = '2025';

SELECT strftime('%d/%M/%Y', '2026-10-14') AS errado,
       strftime('%d/%m/%Y', '2026-10-14') AS certo;

SELECT date('2026-10-14', '+7 dias')   AS em_portugues,
       date('2026-10-14', '+1 week')   AS semana,
       date('2026-10-14', '+7')        AS sem_unidade,
       date('2026-10-14', '+7 days')   AS certo;

SELECT date('14/10/2026')              AS data_br,
       strftime('%Y', '14/10/2026')    AS ano;

SELECT date('2025-01-31', '+1 month')           AS normal,
       date('2025-01-31', '+1 month', 'floor')  AS com_floor,
       date('2024-02-29', '+1 year')            AS bissexto_mais_1_ano;

SELECT YEAR(data) AS ano
FROM pedidos;

Referência rápida

Exercícios

Missão final: os pedidos atrasados

SELECT id, data, entregue_em
FROM pedidos
WHERE entregue_em IS NOT NULL;

SELECT id, data, entregue_em,
       date(data, '+7 days') AS prazo
FROM pedidos
WHERE entregue_em > date(data, '+7 days');

Foram 17 pedidos, todos com 1 dia de atraso. Os 5 pedidos não entregues não aparecem: NULL > … não é verdadeiro. Outra solução certa usa a diferença em dias: WHERE julianday(entregue_em) - julianday(data) > 7.

Resumo

• Toda função de data segue o molde função(data, modificador, …): date (só a data), time (só a hora), datetime (as duas), julianday e unixepoch (números), strftime (o formato que você quiser).
• strftime usa códigos: %Y ano, %m mês, %d dia, %H hora, %M minuto, %w dia da semana (0 = domingo), %j dia do ano. Ele devolve texto: compare com '2025', não com 2025.
• Para agrupar por mês, use strftime('%Y-%m', data), com o ano junto.
• Modificadores andam no calendário, da esquerda para a direita: '+7 days', '-1 month', 'start of month', 'weekday 0'. Em inglês; um modificador errado faz a função devolver NULL.
• Dias entre duas datas: julianday(b) - julianday(a). Último dia do mês: 'start of month', '+1 month', '-1 day'.
• Cuidado com 31/01 + 1 mês (vira 03/03; use 'floor') e com 'now' em resultados que precisam ser fixos.