FORMAT_TIME

Syntaxe

Paramètres

Description

Cette fonction permet de demander une heure selon le formatage et l'expression d'heure spécifié.

Remarques

• FORMAT_TIME permet de transformer un objet TIME en chaîne de caractères formatée : Cette fonction est particulièrement utile pour afficher l'heure sous une forme lisible et personnalisée, sans avoir besoin de manipuler manuellement les composantes de l'objet. Elle transforme des données brutes de type TIME en texte clair.
• Elle s'appuie sur des spécificateurs de format comparables à ceux de strftime : Par exemple, %H représente l'heure au format 24 heures, %I au format 12 heures, %M les minutes, %S les secondes, et %p indique AM/PM. Cela permet de construire facilement un affichage conforme aux standards régionaux ou aux préférences des utilisateurs.
• Le paramètre time_object peut provenir d'une colonne ou d'une expression : On peut utiliser cette fonction aussi bien avec une valeur constante (comme TIME "15:30:00") qu'avec des colonnes d'une base ou même des expressions calculées (comme CURRENT_TIME()). Elle s'intègre donc facilement dans une requête dynamique.
• La sortie est de type STRING, et non TIME : Après formatage, l'heure devient une chaîne de caractères. Cela signifie que le résultat ne peut plus être utilisé pour des calculs temporels, mais uniquement pour des usages d'affichage, de tri lexicographique ou d'export.
• Elle est très utile dans les contextes multilingues ou multi-régions : Grâce à la flexibilité de son format_string, FORMAT_TIME permet d'adapter l'affichage à des conventions locales ou culturelles : format 24h pour l'Europe, 12h avec AM/PM pour l'Amérique du Nord,...
• Les formats personnalisés permettent un affichage convivial : Il est possible d'ajouter des éléments textuels ou des séparateurs dans la chaîne de formatage, par exemple FORMAT_TIME("%I:%M %p", time_col) donne une heure comme "03:45 PM". Cela facilite la création de messages lisibles ou d'interfaces utilisateurs soignées.
• Elle est complémentaire à d'autres fonctions comme FORMAT_DATE et FORMAT_DATETIME : Alors que FORMAT_TIME gère exclusivement les heures sans date, les autres fonctions permettent de formater des dates ou des combinaisons date-heure. Bien choisir entre ces fonctions est crucial selon le type de données manipulé.
• Elle ignore toute notion de fuseau horaire car TIME n'en contient pas : La fonction FORMAT_TIME ne tient pas compte du fuseau horaire, ce qui garantit un affichage constant, mais implique aussi que l'heure doit déjà être correctement ajustée si une conversion temporelle était requise en amont.