Categorias:

Funções de dados semiestruturados e estruturados (Conversão)

AS_TIMESTAMP_*

Converte um valor VARIANT para o respectivo valor de carimbo de data/hora:

  • AS_TIMESTAMP_LTZ (valor com fuso horário local)

  • AS_TIMESTAMP_NTZ (valor sem fuso horário)

  • AS_TIMESTAMP_TZ (valor com fuso horário)

Consulte também:

AS_<tipo_de_objeto> , AS_DATE , AS_TIME

Sintaxe

AS_TIMESTAMP_LTZ( <variant_expr> )

AS_TIMESTAMP_NTZ( <variant_expr> )

AS_TIMESTAMP_TZ( <variant_expr> )
Copy

Argumentos

variant_expr

Uma expressão que avalia como um valor do tipo VARIANT.

Retornos

A função retorna um valor de um tipo de carimbo de data/hora ou NULL:

  • Se o tipo do valor no argumento variant_expr for um tipo de carimbo de data/hora, a função retornará um valor do mesmo tipo de carimbo de data/hora.

  • Se o tipo do valor no argumento variant_expr não corresponder ao tipo do valor de saída, a função retornará NULL.

  • Se o argumento variant_expr for NULL, a função retornará NULL.

Exemplos

Criar uma tabela e carregar dados nela:

CREATE OR REPLACE TABLE as_timestamp_example (timestamp1 VARIANT);

INSERT INTO as_timestamp_example (timestamp1)
  SELECT TO_VARIANT(TO_TIMESTAMP_NTZ('2024-10-10 12:34:56'));
Copy

Use a função AS_TIMESTAMP_NTZ em uma consulta para converter um valor VARIANT em um valor TIMESTAMP_NTZ:

SELECT AS_TIMESTAMP_NTZ(timestamp1) AS timestamp_value
  FROM as_timestamp_example;
Copy
+-------------------------+
| TIMESTAMP_VALUE         |
|-------------------------|
| 2024-10-10 12:34:56.000 |
+-------------------------+