Fonctions de formatage de type

Les fonctions de formatage PostgreSQL procurent un riche ensemble d'outils pour convertir différents types (date/time, integer, floating point, numeric) en chaînes formatées et pour convertir des chaînes formatées en types spécifiques. Ces fonctions suivent toutes une convention d'appel commune : le premier argument est la valeur à formater et le second argument est un gabarit qui définit le format d'entrée ou sortie.

Dans une sortie chaîne modèle, il y a certains modèles reconnus et remplacés par des données appropriées depuis la valeur à formater. Un texte qui n'est pas un modèle de gabarit est simplement recopié mot pour mot. De façon similaire, dans une entrée chaîne modèle, les modèles de gabarit identifient la partie de la donnée d'entrée chaîne à rechercher et les valeurs à retrouver.

Certaines modifications peuvent être appliquées aux modèles de gabarit pour altérer leur comportement. Par exemple, "FMMonth" est le gabarit "Month" avec le préfixe "FM".

Notes d'utilisation :

• FM supprime les zeros ou les blancs qui seraient ajoutés pour permettre que la sortie d'un gabarit soit de largeur fixe.

• to_timestamp et to_date saute les multiples espaces blancs dans la chaîne d'entrée si l'option FX n'est pas utilisée. FX doit être spécifié en premier dans la gabarit; par exemple to_timestamp('2000 JUN','YYYY MON') est correct, mais to_timestamp('2000 JUN','FXYYYY MON') renvoit une erreur, car to_timestamp attend un espace blanc uniquement.

• Si un backslash ("\") est voulu dans une chaîne de constantes, un double backslash ("\\") devra être entré; par exemple '\\HH\\MI\\SS'. Ceci est valable pour n'importe quelle chaîne de constantes dans PostgreSQL.

• Habituellement le texte est admis dans les gabarits to_char et sera affiché littéralement. Vous pouvez placer une sous-chaîne entre guillemets pour la forcer à être interprétée comme du texte littéral même s'il contient des mots-clé de gabarit. Par exemple, dans '"Hello Year: "YYYY', les YYYY seront remplacés par les données année, mais le Y seul ne le sera pas.

• Si vous voulez afficher des guillemets dans la sortie vous devez les faire précéder d'un backslash, par exemple '\\"YYYY Month\\"'.

• La conversion YYYY depuis une chaîne en timestamp ou en date est limitée si vous utilisez une année de plus de quatre chiffres. Vous devez utiliser des caractères qui ne soient pas des chiffres ou des gabarit après YYYY, autrement l'année est toujours interprétée en 4 chiffres. Par exemple, (avec l'année 20000): to_date('200001131', 'YYYYMMDD') sera interprété comme une année à 4 chiffres; le mieux est d'utiliser un séparateur qui ne soit pas un chiffre après l'année, comme to_date('20000-1131', 'YYYY-MMDD') ou to_date('20000Nov31', 'YYYYMonDD').

• Les valeurs US millisecond MS et microsecond US dans une conversion depuis une chaîne vers un timestamp sont utilisées en tant que partie des secondes après le point décimal. Par exemple, to_timestamp('12:3', 'SS:MS') n'est pas 3 millisecondes, mais 300, car la conversion comptera 12 + 0.3. Pour le format SS:MS, les valeurs d'entrée 12:3, 12:30, et 12:300 spécifient le même nombre de millisecondes. Pour obtenir trois millisecondes, on doit utiliser 12:003, qui comptera 12 + 0.003 = 12.003 secondes.

  Ici un exemple plus complexe : to_timestamp('15:12:02.020.001230','HH:MI:SS.MS.US') soit 15 heures, 12 minutes, et 2 secondes + 20 millisecondes + 1230 microsecondes = 2.021230 secondes.

Notes d'utilisation :

• Un signe formaté utilisant SG, PL, ou MI n'est pas une ancre dans le nombre; par exemple, to_char(-12, 'S9999') produit ' -12', bmais to_char(-12, 'MI9999') produit '- 12'. Oracle ne permet pas l'utilisation de MI avant 9, mais nécessite plutôt que 9 précède MI.

• 9 spécifie une valeur avec le même nombre de chiffres qu'il y en a dans les 9. Si un chiffre n'est pas disponible utilisez un expace blanc.

• TH ne convertit pas les valeurs inférieures à zero et ne convertit pas les nombres décimaux.

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

• V multiplie les valeurs d'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. (Ex., 99.9V99 n'est pas admis.)