PARSE_DATETIME |
Analyse la date et l'heure |
| BigQuery |
Syntaxe
|
PARSE_DATETIME(format_string, string)
|
Paramètres
| Nom |
Description |
| format_string |
Ce paramètre permet de définir le modèle de format qui correspond à la manière dont la date et l'heure sont représentées dans la string d'entrée. Il utilise des spécificateurs de format (par exemple, %Y pour l'année, %m pour le mois, %d pour le jour, %H pour l'heure, %M pour les minutes, %S pour les secondes). La fonction utilise ce modèle pour interpréter correctement la chaîne de caractères. |
| string |
Ce paramètre permet de spécifier la chaîne de caractères qui contient la date et l'heure à analyser. Cette chaîne doit correspondre exactement au format défini par format_string pour que l'analyse réussisse. |
Description
Cette fonction permet de demander un objet DATETIME (de date et heure) selon le formatage et une de caractères de date et heure spécifié.
Remarques
- Conversion précise d'une chaîne en objet DATETIME : La fonction PARSE_DATETIME permet de convertir une chaîne de caractères textuelle contenant une
date et une heure en un objet structuré de type DATETIME. C'est une opération essentielle pour manipuler du temps de façon analytique.
- Repose strictement sur la concordance avec le format : La chaîne d'entrée (string) doit correspondre exactement au modèle défini par format_string,
sinon la fonction échoue avec une erreur. Il est donc crucial que le format soit bien défini et adapté à la structure des données textuelles.
- Supporte les spécificateurs strftime détaillés : Le paramètre format_string peut inclure des spécificateurs comme %Y, %m, %d, %H, %M, %S pour indiquer
l'année, le mois, le jour, l'heure, les minutes et les secondes. Cela permet de couvrir une large variété de formats horaires.
- Produit un type DATETIME, sans fuseau horaire : Le résultat de la fonction est de type DATETIME, ce qui signifie qu'il contient la date et l'heure, mais
pas le fuseau horaire. Si la chaîne contient un fuseau (comme "+02:00"), il faut plutôt utiliser PARSE_TIMESTAMP.
- Utile pour l'importation de journaux de bord ou de fichiers plats : Cette fonction est idéale pour analyser des dates et heures issues de fichiers
CSV, JSON ou de journaux d'activité, où les champs temporels sont souvent
en format texte, parfois dans des formats complexes ou non standard.
- Différente de PARSE_DATE et PARSE_TIMESTAMP : PARSE_DATETIME est un juste milieu : elle gère à la fois la date et l'heure, mais pas les informations de
fuseau. En comparaison, PARSE_DATE ne gère que la date, et PARSE_TIMESTAMP prend aussi en compte le fuseau horaire.
- Nécessite une rigueur stricte sur les formats mixtes : En cas de séparation de date et d'heure par des caractères non standards (par exemple, des
underscores ou des textes), il faut adapter précisément le format_string pour qu'il reflète fidèlement la structure de la chaîne.
- Indispensable dans les transformations temporelles complexes : PARSE_DATETIME est particulièrement utile dans les traitements ETL pour uniformiser des
chaînes temporelles non typées, notamment avant des jointures temporelles, des comparaisons de plages horaires, ou des regroupements par heure.
Dernière mise à jour : Jeudi, le 18 Juin 2020
