English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Datas e Horas no SQLite

O SQLite suporta os seguintes cinco funções de data e hora:

NúmeroFunçãoExemplo
1date(timestring, modifier, modifier, ...)Com YYYY-MM-Retorna a data no formato DD.
2time(timestring, modifier, modifier, ...)Retorna a hora no formato HH:MM:SS.
3datetime(timestring, modifier, modifier, ...)Com YYYY-MM-Formato DD HH:MM:SS.
4julianday(timestring, modifier, modifier, ...)Isso retornará a data desde o tempo de Greenwich antes de Cristo. 4714 Ano 11 Mês 24 Número de dias a partir do meio-dia.
5strftime(format, timestring, modifier, modifier, ...)Isso retornará a data formatada com base na string de formato especificada no primeiro parâmetro. A forma específica será explicada a seguir.

As cinco funções de data e hora principais aceitam a string de data como parâmetro. A string de data pode ser seguida por zero ou mais modificadores. A função strftime() também pode usar a string de formato como seu primeiro parâmetro. A seguir, será explicado detalhadamente diferentes tipos de strings de data e modificadores.

String de data

Uma string de data pode ser usada em qualquer um dos seguintes formatos:

NúmeroString de dataExemplo
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:MM30-12-2010 12:10
5HH:MM12:10
6YYYY-MM-DDTHH:MM2010-12-30 12:10
7HH:MM:SS12:10:01
8YYYYMMDD HHMMSS20101230 121001
9agora2013-05-07

Você pode usar "T" como caractere de separação entre data e hora.

Modificador (Modifier)

A string de data pode ser seguida por zero ou mais modificadores, o que mudará a data e o tempo retornados pelos cinco funções acima./ou data. Qualquer uma das cinco funções principais retorna data. O modificador deve ser usado da esquerda para a direita, a seguir está listado os modificadores que podem ser usados no SQLite:

  • NNN dias

  • NNN horas

  • NNN minutos

  • NNN.NNNN segundos

  • NNN meses

  • NNN anos

  • start of month

  • start of year

  • start of day

  • weekday N

  • unixepoch

  • localtime

  • utc

formatação

SQLite oferece funções muito convenientes strftime() para formatar qualquer data e hora. Você pode usar as seguintes substituições para formatar data e hora:

substituiçãodescrição
%do dia do mês, 01-31
%fsegundos com parte decimal, SS.SSS
%Hhora, 00-23
%jo dia do ano, 001-366
%Jnúmero de juliano, DDDD.DDDD
%mmês, 00-12
%Mminuto, 00-59
%sde 1970-01-01 a contagem de segundos desde
%Ssegundo, 00-59
%wo dia da semana, 0-6 (0 é domingo)
%Wa semana do ano, 01-53
%Yano, YYYY
%%símbolo %

Exemplo

Agora vamos usar o prompt do SQLite para tentar vários exemplos. O seguinte comando calcula a data atual.

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

Os seguintes comandos calculam o último dia do mês atual.

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

Os seguintes comandos calculam a data e hora de um timestamp UNIX dado1092941466a data e hora.

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

Os seguintes comandos calculam a data e hora de um timestamp UNIX dado1092941466a data e hora, e compensar sua zona horária local.

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

Os seguintes comandos calculam o timestamp UNIX atual.

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

Os seguintes comandos calculam o número de dias desde a assinatura da Declaração de Independência dos Estados Unidos.

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

Os seguintes comandos calculam o tempo desde2004os segundos desde um momento específico do ano.

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

Os seguintes comandos calculam o ano atual10a data do primeiro terça-feira do mês.

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

Os seguintes comandos calculam o tempo desde a era UNIX em segundos (semelhante ao strftime('%s', 'now'), mas inclui parte decimal).

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

Para converter valores entre tempo UTC e tempo local ao formatar datas, use o modificador utc ou localtime, conforme exemplo a seguir:

sqlite> SELECT time('12:00', 'localtime');
05:00:00
sqlite> SELECT time('12:00', 'utc');
19:00:00