Catégories :

Fonctions de conversion

TRY_TO_TIMESTAMP / TRY_TO_TIMESTAMP_*

Une version spéciale de TO_TIMESTAMP / TO_TIMESTAMP_* qui effectue la même opération (c’est-à-dire convertit une expression d’entrée en horodatage), mais avec une prise en charge du traitement des erreurs (c’est-à-dire que si la conversion ne peut pas être effectuée, elle retourne une valeur NULL au lieu de produire une erreur).

Pour plus d’informations, voir Fonctions de conversion de traitement des erreurs.

Note

TRY_TO_TIMESTAMP mappe vers l’une des autres fonctions d’horodatage, en fonction du paramètre de session TIMESTAMP_TYPE_MAPPING. Le paramètre par défaut est TIMESTAMP_NTZ de sorte que TRY_TO_TIMESTAMP est mappé sur TRY_TO_TIMESTAMP_NTZ par défaut.

Syntaxe

timestampFunction ( <string_expr> [, <format> ] )

Où :

timestampFunction ::=
    TRY_TO_TIMESTAMP | TRY_TO_TIMESTAMP_LTZ | TRY_TO_TIMESTAMP_NTZ | TRY_TO_TIMESTAMP_TZ

Arguments

Obligatoire :

expr_chaîne

L’argument doit être une chaîne pouvant correspondre à TIMESTAMP (TIMESTAMP_NTZ, TIMESTAMP_LTZ ou TIMESTAMP_TZ).

Facultatif :

format

Spécificateur de format pour expr_chaîne ou AUTO. Pour plus d’informations, voir Formats de date et heure dans les fonctions de conversion.

La valeur par défaut est la valeur actuelle du paramètre de session TIMESTAMP_INPUT_FORMAT (généralement AUTO).

Renvoie

Le type de données de la valeur renvoyée est l’un des types de données TIMESTAMP. Par défaut, le type de données est TIMESTAMP_NTZ. Vous pouvez changer cela en définissant le paramètre de session TIMESTAMP_TYPE_MAPPING.

Notes sur l’utilisation

  • Ne fonctionne que pour les expressions de chaîne.

Exemples

Ceci illustre l’utilisation de TRY_TO_TIMESTAMP :

SELECT TRY_TO_TIMESTAMP('2018-09-15 12:30:00'), TRY_TO_TIMESTAMP('Invalid');
+-----------------------------------------+-----------------------------+
| TRY_TO_TIMESTAMP('2018-09-15 12:30:00') | TRY_TO_TIMESTAMP('INVALID') |
|-----------------------------------------+-----------------------------|
| 2018-09-15 12:30:00.000                 | NULL                        |
+-----------------------------------------+-----------------------------+