9.8. Fonctions de formatage des types de données

FM supprime les zéros au début et les espaces en fin qui, autrement, auraient été ajoutés 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 placer 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.

to_char(interval) formate HH et HH12 comme les heures d'un seul jour alors que HH24 peut afficher des heures dépassant un simple jour, c'est-à-dire >24.

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é).