Compartilhar via


SET TIME ZONE

Aplica-se a: marca de seleção positiva SQL do Databricks marca de seleção positiva Runtime do Databricks

Define o fuso horário da sessão atual.

Sintaxe

SET TIME ZONE { LOCAL | time_zone_value | interval_literal }

Parâmetros

  • LOCAL

    Aplica-se a:marca de seleção positiva Databricks Runtime

    Defina o fuso horário como o especificado na propriedade Java user.timezone ou como a variável de ambiente TZ quando user.timezone é indefinido, ou defina-o como o fuso horário do sistema quando ambos são indefinidos.

    Aplica-se a: marca de seleção positiva SQL do Databricks

    Redefine o fuso horário com o valor definido no parâmetro TIMEZONE do comando SET.

    O sistema padrão é UTC.

  • timezone_value

    Uma literal de STRING. A ID do fuso horário local da sessão no formato de IDs de zona baseadas em região ou deslocamentos de zona. As IDs de região devem ter a forma "área/cidade", como "América/Los_Angeles". Deslocamentos de zona devem estar no formato "(+|-)HH", "(+|-)HH:mm" ou "(+|-)HH:mm:ss", por exemplo, "-08", "+ 01:00" ou "-13:33:33". Além disso, "UTC" e "Z" têm suporte como aliases de "+00:00". Não é recomendável usar outros nomes curtos porque eles podem ser ambíguos.

    Para obter uma lista de fusos horários válidos, veja Lista de fusos horários do banco de dados tz.

  • literal de intervalo

    O literal de intervalo representa a diferença entre o fuso horário da sessão e o "UTC". Deve estar no intervalo de [-18, 18] horas e precisão máxima de segundo, por exemplo: INTERVAL '15:40:32' HOUR TO SECOND.

Exemplos

-- Set time zone to the system default.
> SET TIME ZONE LOCAL;

-- Set time zone to the region-based zone ID.
> SET TIME ZONE 'America/Los_Angeles';

-- Set time zone to the Zone offset.
> SET TIME ZONE '+08:00';

-- Set time zone with intervals.
> SET TIME ZONE INTERVAL '08:30:00' HOUR TO SECOND;