PARSE_TIME |
Analyse le temps |
| BigQuery |
Syntaxe
|
PARSE_TIME(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 l'heure est représentée dans la string d'entrée. Il utilise des spécificateurs de format spécifiques à l'heure (par exemple, %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 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 TIME (d'heure) selon le formatage et une de caractères d'heure spécifié.
Remarques
- Convertit une chaîne d'heure en objet TIME structuré : La fonction PARSE_TIME permet de transformer une chaîne de caractères représentant uniquement une
heure (sans date ni fuseau horaire) en un objet TIME. Cela facilite la manipulation et la comparaison de valeurs temporelles pures.
- Utilise un format basé sur les spécificateurs strftime : Le format d'entrée (format_string) doit être construit avec des spécificateurs comme %H (heures),
%M (minutes), et %S (secondes). Toute erreur ou écart par rapport au format attendu génère une exception.
- Ne traite pas les informations de date ni de fuseau horaire : Contrairement à PARSE_DATETIME ou PARSE_TIMESTAMP, cette fonction ne gère que la partie
heure, ce qui est utile lorsque la date est soit absente, soit sans importance pour l'analyse.
- Convient aux colonnes d'heures horaires (plannings, horaires) : Elle est idéale pour analyser des champs comme les horaires de passage, d'ouverture, de
livraison, ou de pointage, où seule l'heure importe, indépendamment de la journée.
- La précision peut aller jusqu'aux fractions de secondes : Le format peut inclure %E*S pour gérer les secondes avec des fractions (par exemple :
14:25:36.123456). C'est essentiel pour des applications comme le journal de transactions ou les mesures précises.
- Nécessite une correspondance exacte entre chaîne et format : Le champ string doit correspondre à la lettre près au format_string. Par exemple,
14:30 échouera si le format attendu est %H:%M:%S, car les secondes sont absentes.
- Particulièrement utile dans les transformations ou les ETL : Lorsqu'on importe des données textuelles depuis des sources externes, PARSE_TIME permet de
structurer proprement les heures pour les comparer, trier ou grouper selon des plages horaires.
- Complète la suite de l'analyse temporel dans BigQuery : PARSE_TIME fait partie de la famille des fonctions d'analyse (PARSE_DATE, PARSE_DATETIME,
PARSE_TIMESTAMP) permettant de convertir du texte brut en types temporels, selon le niveau de précision souhaité.
Dernière mise à jour : Jeudi, le 18 Juin 2020
