parse_timestamp Fonction

S’applique à : Databricks Runtime 18.1 et versions ultérieures

S’il expr s’agit d’une chaîne, l’analyse en fonction TIMESTAMP du premier modèle correspondant dans la liste donnée de formats. Un ou plusieurs formats peuvent référencer une liste prédéfinie de formats. S’il expr s’agit d’un type numérique, l’analyse en tant qu’horodatage Unix.

Syntaxe

parse_timestamp(expr [, { pattern [...] } ])

Arguments

• expr : chaîne ou valeur numérique à analyser dans un TIMESTAMP. Les types acceptés sont les suivants :
  • TINYINT, , SMALLINTINT, ,BIGINT
  • FLOAT, DOUBLE
  • DECIMAL (jusqu’à 18 précisions)
  • STRING
• modèle : liste facultative de modèles d’horodatage ou référence à une liste prédéfinie telle que #iso8601 ou #rfc3339. Les modèles d’horodatage doivent être une chaîne constante. Si aucun modèle n’est spécifié, il équivaut à spécifier #extended.

Retours

Représentant TIMESTAMP l’analyse expr.

Si la expr chaîne est une chaîne, elle est analysée en fonction du premier modèle correspondant. Si aucun des modèles ne correspond, la fonction génère une erreur.

Si la expr valeur est numérique, elle est toujours analysée en tant qu’horodatage Unix.

Si expr c’est NULLle cas, la fonction retourne NULL.

Pour retourner NULL au lieu d’une erreur lors de l’analyse échoue, utilisez try_parse_timestamp la fonction.

Remarques

• Si la liste de modèles contient des NULL valeurs, elles sont ignorées. Si tous les modèles fournis sont NULL, le résultat est NULL.
• Si l’horodatage correspond à un modèle contenant aucune information de fuseau horaire, il est analysé dans le fuseau horaire de session.

Conditions de l’erreur

• CANNOT_PARSE_TIMESTAMP
• DATATYPE_MISMATCH. UNEXPECTED_INPUT_TYPE
• INVALID_PARAMETER_VALUE. MODÈLE
• DATATYPE_MISMATCH. NON_FOLDABLE_INPUT

Exemples

-- Parse timestamp according to default pattern list
> SELECT parse_timestamp('2024-12-09T19:30:01');
 2024-12-09 19:30:01.000

-- Parse a microsecond epoch timestamp using the unix pattern list
> SELECT parse_timestamp('1733772601000000', '#unix');
 2024-12-09 19:30:01.000

-- Bad `expr` that does not match any pattern
> SELECT parse_timestamp('bad input');
  Error: CANNOT_PARSE_TIMESTAMP

-- Use try_parse_timestamp to return NULL instead of error
> SELECT try_parse_timestamp('bad input');
 NULL

-- Extend the default pattern list with custom patterns
> SELECT parse_timestamp(col, "#extended", "dd MMM, yyyy", "MMM d; yy") FROM VALUES ('2024-12-01'), ('02 Dec, 2024'), ('DEC 3; 24') AS t(col)
 2024-12-01 00:00:00.000
 2024-12-02 00:00:00.000
 2024-12-03 00:00:00.000

Référence de modèle

parse_timestamp et try_parse_timestamp la fonction utilisent un jeu de modèles qui diffère de certaines façons du modèle datetime standard utilisé par to_timestamp. Le tableau suivant répertorie tous les symboles de modèle et indique si chacun d’eux est pris en charge :

Listes de modèles

Vous pouvez passer une liste de modèles prédéfinie par nom (par exemple#extended, , #iso8601#unix). Les listes de modèles suivantes sont disponibles :

• common — Modèles couramment trouvés non définis par une norme
• iso8601
• rfc1036, rfc1123, rfc2822, rfc3164, rfc3339, rfc4287, rfc5322, rfc5424, rfc6265, rfc7231, rfc822, rfc850, rfc9110, rfc9557
• unix — Horodatages d’époque Unix uniquement
• étendue — Union de toutes les listes ci-dessus ; également la valeur par défaut lorsqu’aucun modèle n’est spécifié
• extended-dmy : étendu avec des formats spécifiques aux paramètres régionaux DMY
• extended-mdy : étendu avec des formats spécifiques aux paramètres régionaux MDY

Fonctions associées

• Fonction try_parse_timestamp
• Fonction to_timestamp
• Fonction try_to_timestamp
• Modèles Datetime
• TIMEZONE