Table des matières

Search

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

Référence du langage de transformation

Référence du langage de transformation

TO_CHAR (Dates)

TO_CHAR (Dates)

Convertit les dates en chaînes de caractère. TO_CHAR convertit également des valeurs numériques en chaînes. Vous pouvez convertir la date dans le format de votre choix à l'aide de chaînes de format TO_CHAR.

Syntaxe

TO_CHAR(
date
[,
format
] )
Le tableau suivant décrit les arguments de cette commande:
Argument
Obligatoire/
Facultatif
Description
date
Obligatoire
Type de données Date/Heure. Transmet les valeurs de date à convertir en chaînes de caractères. Vous pouvez entrer l'expression de transformation valide de votre choix.
format
Facultatif
Entrez une chaîne de format TO_CHAR valide. La chaîne de format définit le format de la valeur de retour, pas le format pour les valeurs dans l'argument de date. Si vous omettez la chaîne de format, la fonction renvoie une chaîne basée sur le format de date spécifié dans la configuration du mappage.

Valeur de retour

Chaîne.
NULL si une valeur transmise à la fonction est NULL.

Exemples

L'expression suivante convertit les dates dans le port DATE_PROMISED en texte au format MON DD YYYY :
TO_CHAR( DATE_PROMISED, 'MON DD YYYY' )
DATE_PROMISED
RETURN VALUE
Apr 1 1998 12:00:10AM
'Apr 01 1998'
Feb 22 1998 01:31:10PM
'Feb 22 1998'
Oct 24 1998 02:12:30PM
'Oct 24 1998'
NULL
NULL
Si vous omettez l'argument de
format
, TO_CHAR renvoie une chaîne au format de date spécifié dans la configuration du mappage, par défaut : MM/DD/YYYY HH24:MI:SS.US :
TO_CHAR( DATE_PROMISED )
DATE_PROMISED
RETURN VALUE
Apr 1 1998 12:00:10AM
'04/01/1998 00:00:10.000000'
Feb 22 1998 01:31:10PM
'02/22/1998 13:31:10.000000'
Oct 24 1998 02:12:30PM
'10/24/1998 14:12:30.000000'
NULL
NULL
Les expressions suivantes renvoient le jour de la semaine pour chaque date dans un port :
TO_CHAR( DATE_PROMISED, 'D' )
DATE_PROMISED
RETURN VALUE
04-01-1997 12:00:10AM
'3'
02-22-1997 01:31:10PM
'7'
10-24-1997 02:12:30PM
'6'
NULL
NULL
TO_CHAR( DATE_PROMISED, 'DAY' )
DATE_PROMISED
RETURN VALUE
04-01-1997 12:00:10AM
'Tuesday'
02-22-1997 01:31:10PM
'Saturday'
10-24-1997 02:12:30PM
'Friday'
NULL
NULL
L'expression suivante renvoie le jour du mois pour chaque date dans un port :
TO_CHAR( DATE_PROMISED, 'DD' )
DATE_PROMISED
RETURN VALUE
04-01-1997 12:00:10AM
'01'
02-22-1997 01:31:10PM
'22'
10-24-1997 02:12:30PM
'24'
NULL
NULL
L'expression suivante renvoie le jour de l'année pour chaque date dans un port :
TO_CHAR( DATE_PROMISED, 'DDD' )
DATE_PROMISED
RETURN VALUE
04-01-1997 12:00:10AM
'091'
02-22-1997 01:31:10PM
'053'
10-24-1997 02:12:30PM
'297'
NULL
NULL
Les expressions suivantes renvoient l'heure du jour pour chaque date dans un port :
TO_CHAR( DATE_PROMISED, 'HH' ) TO_CHAR( DATE_PROMISED, 'HH12' )
DATE_PROMISED
RETURN VALUE
04-01-1997 12:00:10AM
'12'
02-22-1997 01:31:10PM
'01'
10-24-1997 02:12:30PM
'02'
NULL
NULL
TO_CHAR( DATE_PROMISED, 'HH24' )
DATE_PROMISED
RETURN VALUE
04-01-1997 12:00:10AM
'00'
02-22-1997 01:31:10PM
'13'
10-24-1997 11:12:30PM
'23'
NULL
NULL
L'expression suivante convertit les valeurs de date en valeurs MJD exprimées sous forme de chaînes :
TO_CHAR( SHIP_DATE, 'J')
SHIP_DATE
RETURN_VALUE
Dec 31 1999 03:59:59PM
2451544
Jan 1 1900 01:02:03AM
2415021
L'expression suivante convertit les dates en chaînes au format MM/DD/YY :
TO_CHAR( SHIP_DATE, 'MM/DD/RR')
SHIP_DATE
RETURN_VALUE
12/31/1999 01:02:03AM
12/31/99
09/15/1996 03:59:59PM
09/15/96
05/17/2003 12:13:14AM
05/17/03
Vous pouvez également utiliser la chaîne de format SSSSS dans une expression TO_CHAR. Par exemple, l'expression suivante convertit les dates dans le port SHIP_DATE en chaînes représentant le nombre total de secondes depuis minuit :
TO_CHAR( SHIP_DATE, 'SSSSS')
SHIP_DATE
RETURN_VALUE
12/31/1999 01:02:03AM
3783
09/15/1996 03:59:59PM
86399
Dans les expressions TO_CHAR, la chaîne de format YY produit les mêmes résultats que la chaîne de format RR.
L'expression suivante convertit les dates en chaînes au format MM/DD/YY :
TO_CHAR( SHIP_DATE, 'MM/DD/YY')
SHIP_DATE
RETURN_VALUE
12/31/1999 01:02:03AM
12/31/99
09/15/1996 03:59:59PM
09/15/96
05/17/2003 12:13:14AM
05/17/03
L'expression suivante renvoie la semaine du mois pour chaque date dans un port :
TO_CHAR( DATE_PROMISED, 'W' )
DATE_PROMISED
RETURN VALUE
04-01-1997 12:00:10AM
'01'
02-22-1997 01:31:10AM
'04'
10-24-1997 02:12:30PM
'04'
NULL
NULL
L'expression suivante renvoie la semaine de l'année pour chaque date dans un port :
TO_CHAR( DATE_PROMISED, 'WW' )
DATE_PROMISED
RETURN VALUE
04-01-1997 12:00:10PM
'18'
02-22-1997 01:31:10AM
'08'
10-24-1997 02:12:30AM
'43'
NULL
NULL

Conseil

Vous pouvez associer TO_CHAR et TO_DATE pour convertir une valeur numérique pour un mois en valeur de texte pour un mois à l'aide d'une fonction telle que la suivante :
TO_CHAR( TO_DATE( numeric_month, 'MM' ), 'MONTH' )