Categorias:

Funções de contexto (General)

LOCALTIME

Retorna a hora atual do sistema.

Alias compatível com ANSI para CURRENT_TIME.

Sintaxe

LOCALTIME()

LOCALTIME
Copy

Argumentos

Nenhum.

Retornos

Retorna um valor do tipo TIME.

Notas de uso

  • O ajuste do parâmetro TIMEZONE afeta o valor de retorno. A hora retornada está no fuso horário da sessão.

  • O formato de exibição das horas na saída é determinado pelo parâmetro de sessão TIME_OUTPUT_FORMAT (padrão HH24:MI:SS).

  • Para cumprir o padrão ANSI, esta função pode ser chamada sem parênteses em instruções SQL.

    Entretanto, se você estiver configurando uma variável Snowflake Scripting para uma expressão que chama a função (por exemplo, my_var := <function_name>();), é necessário incluir os parênteses. Para obter mais informações, consulte as notas de uso para funções de contexto.

  • Não utilize o valor de retorno para ordenações de tempo precisas entre consultas simultâneas (processadas pelo mesmo warehouse virtual), pois as consultas podem ser atendidas por recursos de computação diferentes (no warehouse).

Exemplos

Mostrar a hora local atual e o carimbo de data/hora local:

SELECT LOCALTIME(), LOCALTIMESTAMP();
Copy
+-------------+-------------------------------+
| LOCALTIME() | LOCALTIMESTAMP()              |
|-------------+-------------------------------|
| 15:32:45    | 2024-04-17 15:32:45.775 -0700 |
+-------------+-------------------------------+
Linguagem: Português