Função de tempo SQLite

Resumo : neste tutorial, você aprenderá como usar a time()função SQLite para manipular dados de tempo.

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

A função SQLite time()aceita uma string de tempo e um ou mais modificadores. Ele retorna uma string que representa um horário específico neste formato: HH:MM:SS.

O seguinte mostra a sintaxe da time()função:

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

Nesta sintaxe:

• Pode time_stringser qualquer string de tempo válida definida pelo SQLite. Por exemplo, a nowstring retorna a hora atual. O time_stringpode ser específico, como05:20:30
• Cada um modifiertransforma o valor do tempo à sua esquerda. A transformação é da esquerda para a direita, portanto, a ordem dos modificadores é significativa e afeta o resultado da time()função.

Para obter informações sobre a string de tempo e o modificador, confira o date()tutorial da função.

Veja o exemplo a seguir:

SELECT  
    time('10:20:30','+2 hours');
Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

A saída é:

12:20:30
Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

Neste exemplo, o +2 hoursmodificador adiciona 2 horas à sequência de tempo 10:20:30que resulta em 12:20:30.

time()Exemplos de funções SQLite

Vamos dar alguns exemplos para entender melhor a time()função.

Obtendo exemplo da hora atual

Para obter a hora atual em UTC, você usa a seguinte instrução:

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

Se você deseja obter a hora local atual em vez da hora UTC, você precisa passar o localtimemodificador para a função:

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

Exemplo de adição de valor de tempo

Para adicionar um valor de tempo a um tempo, você usa os modificadores +NNN hours, +NNN minutes, .+NNN seconds

Observe que isso sé opcional, então você pode usar +1 hourou +2 hours.

O exemplo a seguir mostra como adicionar 1 hour 20 minutesum valor de tempo:

SELECT
    time('10:20:30','+1 hours','+20 minutes')
Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

A saída é:

11:40:30
Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

Exemplo de subtração do valor do tempo

Para subtrair um valor de tempo de um tempo, você usa os modificadores -NNN hours, -NNN minutes, .-NNN seconds

Por exemplo, a instrução a seguir ilustra como subtrair 2 hours 15 minutesde um valor de tempo:

SELECT
    time('10:20:30','-2 hours','-15 minutes')
Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

Aqui está a saída:

08:05:30
Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

Extraindo dados de hora de um valor datetime

Você pode usar a função time para extrair dados de hora de um valor de data e hora. Veja o exemplo a seguir:

SELECT 
    time('2018-11-02 15:20:15');
Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

A saída é a parte da hora do valor da data e hora:

15:20:15
Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

Neste tutorial, você aprendeu como usar a time()função SQLite para manipular dados de tempo.