Table des matières

Search

  1. Préface
  2. Le langage de transformation
  3. Constantes
  4. Opérateurs
  5. Variables
  6. Dates
  7. Fonctions

Transformation Language Reference

Transformation Language Reference

Chaînes de format TO_CHAR

Chaînes de format TO_CHAR

La fonction TO_CHAR convertit un type de données Date/Heure en une chaîne ayant le format que vous spécifiez. Vous pouvez convertir la totalité de la date ou une partie de la date en chaîne. Vous pouvez utiliser TO_CHAR pour convertir des dates en chaînes, en modifiant le format à des fins d'établissement de rapports.
TO_CHAR est généralement utilisé quand la cible est un fichier plat ou une base de données ne prenant pas en charge un type de données Date/Heure.
Le tableau suivant récapitule les chaînes de format pour les dates dans la fonction TO_CHAR :
Chaîne de format
Description
AM, A.M.,
PM, P.M.
Indicateur méridien. Utilisez ces chaînes de format pour indiquer les heures AM (matin) et PM (après-midi). AM et PM renvoient les mêmes valeurs que A.M. et P.M.
D
Jour de la semaine (1-7), où dimanche est égal à 1.
DAY
Nom du jour, comprenant jusqu'à neuf caractères (par exemple, dimanche).
DD
Jour du mois (01-31).
DDD
Jour de l'année (001 à 366, incluant les années bissextiles).
DY
Nom du jour abrégé (trois caractères) (par exemple, mer).
HH, HH12
Heure du jour (01-12).
HH24
Heure du jour (00 à 23), où 00 correspond à minuit (12 AM).
J
Date ordinale modifiée. Convertit la date calendaire en une chaîne équivalente à sa valeur Date ordinale modifiée, calculée à partir du 1er janvier 4713 av. J.-C. à 00:00:00. Elle ignore l'élément heure de la date. Par exemple, l'expression TO_CHAR( SHIP_DATE, ‘J’ ) convertit Dec 31 1999 23:59:59 en chaîne 2451544.
MI
Minutes (00-59).
MM
Mois (01-12).
MONTH
Nom de mois, comprenant jusqu'à neuf caractères (par exemple, janvier).
MON
Nom de mois abrégé à trois caractères (par exemple, Jan).
MS
Millisecondes (0 à 999).
NS
Nanosecondes (0 à 999999999).
Q
Trimestre de l'année (1-4), où janvier à mars est égal à 1.
RR
Deux derniers chiffres d'une année. La fonction supprime les premiers chiffres. Par exemple, si vous utilisez « RR » et transmettez l'année 1997, TO_CHAR renvoie 97. Utilisé avec TO_CHAR, « RR » produit les mêmes résultats que « YY » et est interchangeable avec lui. Cependant, utilisé avec TO_DATE, « RR » calcule le siècle approprié le plus proche et fournit les deux premiers chiffres de l'année.
SS
Secondes (00-59).
SSSSS
Secondes depuis minuit (00000 - 86399). Quand vous utilisez SSSSS dans une expression TO_CHAR, le
Service d'intégration de données
évalue uniquement la portion heure d'une date. Par exemple, l'expression TO_CHAR(SHIP_DATE, ‘MM/DD/YYYY SSSSS’) convertit 12/31/1999 01:02:03 en 12/31/1999 03723.
US
Microsecondes (0 à 999999).
Y
Dernier chiffre d'une année. La fonction supprime les premiers chiffres. Par exemple, si vous utilisez « Y » et transmettez l'année 1997, TO_CHAR renvoie 7.
YY
Deux derniers chiffres d'une année. La fonction supprime les premiers chiffres. Par exemple, si vous utilisez « YY » et transmettez l'année 1997, TO_CHAR renvoie 97.
YYY
Trois derniers chiffres d'une année. La fonction supprime les premiers chiffres. Par exemple, si vous utilisez « YYY » et que vous transmettez l'année 1997, TO_CHAR renvoie 997.
YYYY
Portion entière de l'année d'une date. Par exemple, si vous utilisez « YYYY » et que vous transmettez l'année 1997, TO_CHAR renvoie 1997.
W
Semaine du mois (1-5), où la semaine 1 démarre le premier jour du mois et se termine au septième et où la semaine 2 démarre le huitième jour et se termine le quatorzième. Par exemple, Feb 1 indique la première semaine de février.
WW
Semaine de l'année (01-53) où la semaine 1 démarre le 1er janvier et se termine le 7 janvier, où la semaine 2 commence le 8 janvier et se termine le 14 janvier, et ainsi de suite.
- / . ; :
Ponctuation affichée dans la sortie. Vous pouvez utiliser ces symboles pour séparer les parties de date. Par exemple, vous créez l'expression suivante pour séparer les parties de date par un point : TO_CHAR( DATES, ‘MM.DD.YYYY’ ).
"texte"
Texte affiché dans la sortie. Par exemple, si vous créez un port de sortie avec l'expression : TO_CHAR( DATES, ‘MM/DD/YYYY “Les ventes ont progressé”’ ) et que vous transmettez la date Avr 1 1997, la fonction renvoie la chaîne « 04/01/1997 Les ventes ont progressé ». Vous pouvez entrer des caractères multioctets qui sont valides dans la page de code du référentiel.
“”
Utilisez des guillemets pour séparer des chaînes de format ambiguës, par exemple D“”DDD. Les guillemets vides ne s'affichent pas dans la sortie.
La chaîne de format n'est pas sensible à la casse. Elle doit toujours être entourée de guillemets simples.