Catégories :: Fonctions de données semi-structurées et structurées (prédicats de type)

IS_TIMESTAMP_*¶

Vérifie si une valeur VARIANT contient la valeur TIMESTAMP respective :

IS_TIMESTAMP_LTZ (valeur avec fuseau horaire local).
IS_TIMESTAMP_NTZ (valeur sans fuseau horaire).
IS_TIMESTAMP_TZ (valeur avec fuseau horaire).

Voir aussi :: IS_<type_objet> , IS_DATE , IS_DATE_VALUE , IS_TIME

Syntaxe¶

IS_TIMESTAMP_LTZ( <variant_expr> )

IS_TIMESTAMP_NTZ( <variant_expr> )

IS_TIMESTAMP_TZ( <variant_expr> )

Copy

Arguments¶

variant_expr: Une expression qui correspond à une valeur de type VARIANT.

Renvoie¶

La fonction renvoie une valeur de type BOOLEAN.

Exemples¶

Affichez toutes les valeurs TIMESTAMP_* dans une colonne VARIANT, la sortie utilisant le fuseau horaire spécifié pour la session.

Note

Le format de sortie du fuseau horaire est défini à l’aide d’un paramètre :

Le paramètre TIMESTAMP_LTZ_OUTPUT_FORMAT définit le format des valeurs TIMESTAMP_LTZ.
Le paramètre TIMESTAMP_NTZ_OUTPUT_FORMAT définit le format des valeurs TIMESTAMP_NTZ.
Le paramètre TIMESTAMP_TZ_OUTPUT_FORMAT définit le format des valeurs TIMESTAMP_TZ.

Dans ces exemples, le fuseau horaire local est l’heure normale du Pacifique US (-08:00 par rapport à GMT/UCT).

Créer et charger la table :

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

Afficher les valeurs TIMESTAMP dans la table :

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" |
+---------------------------------+