Categorias:: Funções de dados semiestruturados e estruturados (Predicados de tipo)

IS_TIMESTAMP_*¶

Verifica se um valor de VARIANT contém o respectivo valor de TIMESTAMP:

IS_TIMESTAMP_LTZ (valor com fuso horário local).
IS_TIMESTAMP_NTZ (valor sem fuso horário).
IS_TIMESTAMP_TZ (valor com fuso horário).

Consulte também:: IS_<tipo_de_objeto> , IS_DATE , IS_DATE_VALUE , IS_TIME

Sintaxe¶

IS_TIMESTAMP_LTZ( <variant_expr> )

IS_TIMESTAMP_NTZ( <variant_expr> )

IS_TIMESTAMP_TZ( <variant_expr> )

Copy

Argumentos¶

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

Retornos¶

Esta função retorna um valor do tipo BOOLEAN.

Exemplos¶

Mostrar todos os valores TIMESTAMP_* em uma coluna VARIANT, com a saída usando o fuso horário especificado para a sessão.

Nota

O formato de saída para o fuso horário é definido usando um parâmetro:

O parâmetro TIMESTAMP_LTZ_OUTPUT_FORMAT define o formato para valores TIMESTAMP_LTZ.
O parâmetro TIMESTAMP_NTZ_OUTPUT_FORMAT define o formato para valores TIMESTAMP_NTZ.
O parâmetro TIMESTAMP_TZ_OUTPUT_FORMAT define o formato para valores TIMESTAMP_TZ.

Nestes exemplos, o fuso horário local é Horário Padrão do Pacífico US (-08:00 relativo em relação a GMT/UCT).

Criar e carregar a tabela:

CREATE OR REPLACE TABLE vardttm (v VARIANT);

Copy

INSERT INTO vardttm SELECT TO_VARIANT(TO_DATE('2024-02-24'));
INSERT INTO vardttm SELECT TO_VARIANT(TO_TIME('20:57:01.123456789+07:00'));
INSERT INTO vardttm SELECT TO_VARIANT(TO_TIMESTAMP('2023-02-24 12:00:00.456'));
INSERT INTO vardttm SELECT TO_VARIANT(TO_TIMESTAMP_LTZ('2022-02-24 13:00:00.123 +01:00'));
INSERT INTO vardttm SELECT TO_VARIANT(TO_TIMESTAMP_NTZ('2021-02-24 14:00:00.123 +01:00'));
INSERT INTO vardttm SELECT TO_VARIANT(TO_TIMESTAMP_TZ('2020-02-24 15:00:00.123 +01:00'));

Copy

Mostrar os valores de TIMESTAMP nos dados:

SELECT * FROM vardttm WHERE IS_TIMESTAMP_NTZ(v);

Copy

+---------------------------+
| V                         |
|---------------------------|
| "2023-02-24 12:00:00.456" |
| "2021-02-24 14:00:00.123" |
+---------------------------+

SELECT * FROM vardttm WHERE IS_TIMESTAMP_LTZ(v);

Copy

+---------------------------------+
| V                               |
|---------------------------------|
| "2022-02-24 04:00:00.123 -0800" |
+---------------------------------+

SELECT * FROM vardttm WHERE IS_TIMESTAMP_TZ(v);

Copy

+---------------------------------+
| V                               |
|---------------------------------|
| "2020-02-24 15:00:00.123 +0100" |
+---------------------------------+