A função CURRENT_DATE retorna a data atual em um fuso horário especificado como um valor DATE.
Sintaxe
DATE CURRENT_DATE([STRING <time_zone>])
Exemplo:
-- Returns 2025-09-24.
SELECT CURRENT_DATE('Asia/Shanghai');
Parâmetros
|
Parâmetro |
Obrigatório |
Tipo |
Descrição |
|
|
Não |
|
Fuso horário da data retornada. Aceita nomes de fuso horário IANA (por exemplo, |
Valor de retorno
Retorna um valor DATE ou NULL caso a entrada seja NULL.
Observações de uso
O fuso horário padrão do projeto é
UTC+08:00. Quando nenhum argumentotime_zoneé fornecido e não há fuso horário definido na sessão, a função adota esse padrão automaticamente.O parâmetro
time_zoneaceita três formatos equivalentes: nomes IANA (comoAsia/Shanghai), strings de deslocamento UTC (ex.:UTC-10:00) e deslocamentos numéricos curtos (como-10). Todos identificam o mesmo fuso horário de forma intercambiável.
Exemplos
Os exemplos abaixo consideram Asia/Shanghai como fuso horário do projeto atual, com a hora definida para 2025-09-24 17:08:32.274.
Exemplo 1: Obter a data atual no fuso horário da sessão ou do projeto.
-- Returns the date in the session's time zone.
-- Returns 2025-09-24.
SELECT CURRENT_DATE();
Exemplo 2: Obter a data atual no fuso horário do Havaí (UTC-10:00).
-- Returns 2025-09-23.
SELECT CURRENT_DATE('Pacific/Honolulu');
-- Equivalent statement using a UTC offset string. Returns 2025-09-23.
SELECT CURRENT_DATE('UTC-10:00');
-- Equivalent statement using a short numeric offset. Returns 2025-09-23.
SELECT CURRENT_DATE('-10');
Exemplo 3: Passar NULL como argumento.
-- Returns NULL.
SELECT CURRENT_DATE(NULL);
Funções relacionadas
A função CURRENT_DATE pertence à categoria de funções de data. Para consultar outras opções, consulte Funções de data.