Todos os produtos
Search
Central de documentação

MaxCompute:CURRENT_DATE

Última atualização: Jun 26, 2026

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

time_zone

Não

STRING

Fuso horário da data retornada. Aceita nomes de fuso horário IANA (por exemplo, Asia/Shanghai), strings de deslocamento UTC (como UTC+08:00) e deslocamentos numéricos curtos (ex.: +8). Se omitido, a função utiliza o fuso horário da sessão ou do projeto atual.

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 argumento time_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_zone aceita três formatos equivalentes: nomes IANA (como Asia/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.