PARSE_TIMESTAMP |
Analyse l'horodatage |
|---|---|
| BigQuery | |
Syntaxe
| PARSE_TIMESTAMP(format_string, string[, time_zone]) |
Paramètres
| Nom | Description |
|---|---|
| format_string | Ce paramètre permet de définir le modèle de format qui correspond à la manière dont l'horodatage est représenté 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, %E*S pour les fractions de seconde, etc.). 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 l'horodatage à analyser. Cette chaîne doit correspondre exactement au format défini par format_string pour que l'analyse réussisse. |
| time_zone | Ce paramètre facultatif permet de définir le fuseau horaire à utiliser pour interpréter la string d'entrée si celle-ci ne contient pas d'informations de fuseau horaire. Si ce paramètre est omis, BigQuery utilise le fuseau horaire par défaut de la session ou du projet. Le fuseau horaire doit être une chaîne de caractères valide (par exemple, 'America/New_York' ou 'UTC'). |
Description
Cette fonction permet de demander un objet TIMESTAMP (d'horodatage) selon le formatage et une de caractères d'horodatage spécifié.
Remarques
- Transforme une chaîne textuelle en objet TIMESTAMP précis : La fonction PARSE_TIMESTAMP permet de convertir une chaîne de texte représentant une date et une heure en un objet TIMESTAMP, qui est un type natif dans BigQuery représentant une date-heure avec fuseau horaire.
- Prend en charge les fuseaux horaires explicites ou implicites : Si la chaîne analysée ne contient pas d'information de fuseau, on peut utiliser le paramètre time_zone pour préciser dans quel fuseau horaire interpréter la date-heure. Cela garantit une cohérence temporelle, surtout lors de l'import de données de sources diverses.
- S'appuie sur les spécificateurs strftime standards : Le paramètre format_string doit respecter la syntaxe de formatage des dates (%Y, %m, %d, %H, %M, %S,...), ce qui permet d'adapter la fonction à presque tous les formats temporels rencontrés dans les fichiers sources ou API.
- Gère les fractions de secondes pour plus de précision : Avec des spécificateurs comme %E*S, il est possible d'analyser des horodatages à la microseconde. C'est indispensable pour les systèmes de journalisation, de suivi de transactions ou de mesures scientifiques.
- La concordance exacte du format est obligatoire : La chaîne de caractères (string) doit correspondre exactement au format spécifié dans format_string. Le moindre écart (un espace, une absence de secondes, etc.) provoquera une erreur d'analyse.
- Complète les autres fonctions d'analyse temporel : Contrairement à PARSE_DATE, PARSE_TIME ou PARSE_DATETIME, cette fonction produit un horodatage absolu avec fuseau. C'est la version la plus complète pour représenter des moments précis dans le temps universel.
- Permet une analyse temporelle rigoureuse : L'utilisation de PARSE_TIMESTAMP est indispensable dans les analyses où le fuseau horaire et la précision temporelle sont critiques, par exemple pour des comparaisons entre événements provenant de différentes régions du globe.
- Peut poser problème en cas d'ambiguïtés horaires (exemple changement d'heure) : Lorsqu'un time_zone est spécifié et que la chaîne d'entrée se situe dans une période d'heure d'été/hiver, il peut exister des ambigüités d'interprétation, d'où l'importance de s'assurer que l'horodatage source est complet ou explicite.
Dernière mise à jour : Jeudi, le 18 Juin 2020