Função data e hora SQLite

Resumo : neste tutorial, você aprenderá como usar a datetime()função SQLite para manipular valores de data e hora.

Introdução à datetime()função SQLite

A datetime()função aceita uma sequência de tempo e um ou mais modificadores. a sintaxe da datetime()função é a seguinte:

datetime(time_string, modifier, modifier,...)
Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

Nesta sintaxe:

• Especifica time_stringuma data e hora específica, por exemplo,  nowpara a data e hora atual.
• Cada modificador modifica o valor de data e hora à sua esquerda. A função avalia os argumentos da esquerda para a direita, portanto, a ordem dos argumentos é importante.

A datetime()função retorna um valor de data e hora neste formato:YYYY-MM-DD HH:MM:SS

Por exemplo, a seguinte instrução retorna a hora atual de ontem:

SELECT datetime('now','-1 day','localtime');    
Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

Nesta declaração:

• Primeiro, a nowstring de hora retorna a data e hora atuais.
• Segundo, o -1 daymodificador é aplicado à data e hora atual que resulta na hora atual de ontem.
• Terceiro, o localtimemodificador instrui a função a retornar a hora local.

datetime()Exemplos de funções SQLite

A instrução a seguir retorna a data e hora atuais no horário local:

SELECT datetime('now','localtime');
Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

Para retornar a data e hora atuais em UTC, use a seguinte instrução:

SELECT datetime('now');
Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

A instrução a seguir cria uma nova tabela nomeada referralscom três colunas: id, sourcee created_at.

CREATE TABLE referrals(
    id INTEGER PRIMARY KEY,
    source TEXT NOT NULL,
    created_at TEXT DEFAULT CURRENT_TIMESTAMP
);
Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

A created_atcoluna tem um valor padrão que CURRENT_TIMESTAMPé a data e hora atuais em UTC.

Para inserir dados na referralstabela, você usa a seguinte INSERTinstrução:

INSERT INTO referrals(source)
VALUES ('Search Engines'),
    ('Social Network'),
    ('Email');
Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

A consulta a seguir retorna os dados da referralstabela:

SELECT 
    source,
    created_at
FROM
    referrals; 
Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

Conforme mostrado claramente na saída, os dados na created_atcoluna na hora criada em UTC.

Para converter esses valores de hora criados para a hora local, você usa a datetime()função conforme mostrado na seguinte consulta:

SELECT 
    source,
    datetime(created_at,'localtime') as created_at
FROM
    referrals;
Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

Neste tutorial, você aprendeu como usar a datetime()função SQLite para manipular valores de data e hora.