9.8. Fonctions de formatage des types de données

Les fonctions de formatage de PostgreSQL fournissent un ensemble d'outils puissants pour convertir différent types de données (date/heure, entier, nombre à virgule flottante, numérique) en des chaînes formatées et pour convertir des chaînes formatées en des types de données spécifiques. Tableau 9-20 les listes. Ces fonctions suivent toutes une convention d'appels commune : le premier argument est la valeur à formater et le second argument est un modèle définissant le format de sortie ou d'entrée.

Attention : to_char(interval, text) est obsolète et ne devrait plus être utilisé dans du code nouvellement écrit. Elle sera supprimée dans la prochaine version.

Dans une chaîne modèle en sortie (for to_char), certains modèles sont reconnus et remplacés avec les données proprement formatées à partir de la valeur à formater. Tout texte qui n'est pas un modèle est copié sans modification. De même, sur une chaîne modèle en entrée (pour tout sauf to_char), les modèles identifient les parties de la chaîne en entrée à récupérer et les valeurs à trouver.

Tableau 9-21 affiche les modèles disponibles pour formater les valeurs de types date et heure.

Certains modificateurs peuvent être appliqués à tout modèle pour changer leur comportement. Par exemple, FMMonth est le modèle Month avec le modificateur FM. Tableau 9-22 affiche les modificateurs de modèles pour le formatage des dates/heures.

Notes d'utilisation pour le formatage date/heure :

• FM supprime les zéro au début et les espaces en fin qui, autrement aurait été ajouté pour que la sortie du modèle soit de taille fixe.

• to_timestamp et to_date passent les espaces blancs multiples de la chaîne en entrée si l'option FX n'est pas utilisée. FX doit être spécifié et être le premier élément du modèle. Par exemple, to_timestamp('2000    JUN', 'YYYY MON') est correct mais to_timestamp('2000    JUN', 'FXYYYY MON') renvoie une erreur car to_timestamp n'attend qu'un seul espace.

• Le texte ordinaire est autorisé dans les modèles to_char et sera remis en sortie de façon littérale. Vous pouvez placez une sous-chaîne entre des guillemets doubles pour forcer son interprétation en tant que texte littéral même s'il contient des mots clés de modèles. Par exemple, dans '"Hello Year "YYYY', les caractères YYYY seront remplacés par l'année mais le seul Y du mot Year ne le sera pas.

• Si vous voulez avoir un guillemet double dans la sortie, vous devez le précéder d'un antislash, par exemple '\\"YYYY Month\\"'. (Deux antislashs sont nécessaire parce qu'un seul antislash a déjà une signification spéciale dans une chaîne.)

• La conversion YYYY d'une chaîne vers un champ de type timestamp ou date a une restriction dans le cas où vous utilisez une année avec plus de quatre chiffres. Vous devez utiliser des caractères non numériques ou un modèle après YYYY, sinon l'année sera toujours interprétée sur quatre chiffres. Par exemple, pour l'année 20000) : to_date('200001131', 'YYYYMMDD') sera interprété comme une année à quatre chiffres ; utilisez à la place un séparateur non décimal après l'année comme to_date('20000-1131', 'YYYY-MMDD') ou to_date('20000Nov31', 'YYYYMonDD').

• Dans les conversions des chaînes de caractères vers timestamp ou date, le champ CC est ignoré s'il y a un champ YYY, YYYY ou Y,YYY. Si CC est utilisé avec YY ou Y, alors l'année est calculée comme (CC-1)*100+YY.

• Les valeurs en millisecondes (MS) et microsecondes (US) dans une conversion d'une chaîne vers un champ de type timestamp sont utilisées comme faisant partie de la fraction décimale des secondes. Par exemple, to_timestamp('12:3', 'SS:MS') n'est pas trois millisecondes mais 300 car la conversion le compte comme 12 + 0,3 secondes. Ceci signifie que le format SS:MS, les valeurs d'entrées 12:3, 12:30 et 12:300 spécifient le même nombre de millisecondes. Pour obtenir trois millisecondes, vous devez utiliser 12:003 car la conversion compte avec 12 + 0,003 = 12,003 secondes.

  Voici un exemple encore plus complexe : to_timestamp('15:12:02.020.001230', 'HH:MI:SS.MS.US') représente 15 heures, 12 minutes et 2 secondes + 20 millisecondes + 1230 microsecondes = 2,021230 secondes.

• la numérotation du jour de la semaine de to_char (voir le modèle de formatage de 'D') est différente de celle de la fonction extract.

Tableau 9-23 affiche les modèles disponibles pour le formatage des valeurs numériques.

Notes d'utilisation pour le formatage des nombres :

• Un signe formaté en utilisant SG, PL ou MI n'est pas ancré au nombre ; par exemple, to_char(-12, 'S9999') produit '  -12' mais to_char(-12, 'MI9999') produit '-  12'. L'implémentation Oracle n'autorise pas l'utilisation de MI devant 9, mais requiert plutôt que 9 précède MI.

• 9 résulté en une valeur avec le même nombre de chiffre. Si un chiffre n'est pas disponible, il est remplacé par un espace.

• TH ne convertit pas les valeurs inférieures à zéro et ne convertit pas les nombres à fraction.

• PL, SG, et TH sont des extensions PostgreSQL.

• V multiplie effectivement les valeurs en entrée par 10^n, où n est le nombre de chiffres suivant V. to_char ne supporte pas l'utilisation de V combiné avec un point décimal. (donc 99.9V99 n'est pas autorisé.)

Tableau 9-24 affiche quelques exemples de l'utilisation de la fonction to_char.