STRING

Syntaxe

Paramètres

Description

Cette fonction permet de convertir un horodatage, avec un fuseau horaire facultatif, en chaîne de caractères.

Remarques

• Conversion explicite d'un TIMESTAMP en texte lisible : La fonction STRING() est utile pour afficher ou exporter un champ TIMESTAMP dans un format plus lisible. Elle convertit la date et l'heure en texte selon un format standard (généralement ISO 8601), facilitant son intégration dans des rapports ou des systèmes ne gérant pas les types temporels.
• Format dépendant du fuseau horaire : Le résultat de la conversion dépend du fuseau horaire précisé. Par défaut, BigQuery utilise le fuseau horaire du projet ou de la session. En passant une valeur comme 'UTC' ou 'America/Toronto', vous pouvez ajuster l'heure convertie en fonction du contexte géographique ou réglementaire.
• Peut être utile pour les exports CSV ou JSON : Lorsqu'on souhaite exporter des données vers des formats texte comme CSV ou JSON, il est souvent nécessaire de convertir les champs TIMESTAMP en chaînes. STRING() permet cette transformation sans perdre la précision temporelle.
• Résultat toujours au format STRING : Peu importe le contenu du timestamp_expression, la fonction retournera une valeur textuelle. Cela signifie qu'aucune opération temporelle ne peut être effectuée sur le résultat sans le reconvertir au préalable.
• Indispensable pour la concaténation avec d'autres textes : Si vous devez concaténer un TIMESTAMP avec du texte (exemple : "Date : " + TIMESTAMP), vous devrez obligatoirement utiliser STRING() pour convertir le TIMESTAMP en chaîne compatible avec l'opération.
• Attention aux décalages si le fuseau n'est pas précisé : Si vous ne précisez pas de fuseau horaire, vous pourriez avoir des surprises avec des valeurs converties ne reflétant pas la zone géographique prévue. Cela peut provoquer des erreurs d'interprétation dans les rapports ou les traitements ultérieurs.
• Supporte les champs TIMESTAMP et expressions temporelles complexes : En plus des champs simples, STRING() accepte comme paramètre des expressions temporelles calculées, comme CURRENT_TIMESTAMP() ou TIMESTAMP_ADD(...), ce qui en fait un outil flexible dans les transformations de données.
• Complémentaire de PARSE_TIMESTAMP : Cette fonction est l'inverse de PARSE_TIMESTAMP, permettant de reconvertir une chaîne en TIMESTAMP. Utilisées ensemble, ces fonctions facilitent les allers-retours entre représentation texte et représentation temporelle pour validation, affichage ou échange de données.