Administration d'Oracle CRM On Demand > Expression Builder > Fonction Expression Builder > ToChar
ToChar
La fonction ToChar d'Expression Builder convertit une date ou une expression numérique spécifiée en une chaîne formatée.
Syntaxe
ToChar(expression, format)
ATTENTION : N'utilisez pas les formats de date et de nombre dans une instance de la fonction ToChar. Vous risquez d'obtenir des résultats incorrects.
Type du résultat
Chaîne
Arguments
Le tableau suivant décrit les arguments de la fonction.
Argument
|
Description
|
expression
|
Expression ou champ qui renvoie une date, une valeur de date et heure ou une valeur numérique.
|
format
|
Chaîne représentant le format de la date ou du nombre.
|
Le tableau suivant décrit les formats de date pour la fonction.
Code de format
|
Description
|
DD
|
Jour du mois sur deux chiffres (01 à 31).
|
JJJJ
jjjj
|
Nom du jour.
|
MM
|
Un numéro de mois composé de deux chiffres (01-12, 01 correspondant au mois de janvier). Vous devez utiliser MM en majuscules parce que mm en minuscules désigne les minutes.
|
MMMM
mmmm
|
Nom du mois. Notez que si vous utilisez des minuscules, vous devez indiquer mmmm (la lettre m répétée quatre fois en minuscules) car la mention mm (la lettre m répétée deux fois en minuscules) désigne les minutes.
|
O
|
Dernier chiffre de l'année.
|
YY
|
Deux derniers chiffres de l'année.
|
YYYY
|
Année sur quatre chiffres.
|
hh12
|
Heure au format 12 heures.
|
hh24
|
Heure au format 24 heures.
|
hh
|
Heure du jour. Vous pouvez spécifier AM ou PM pour ajuster l'heure en conséquence ; par exemple :
hh:mm:ss PM
Si vous n'indiquez pas AM ou PM, le format 24 heures est utilisé par défaut.
|
mm
|
Minutes. Notez que la mention mm (la lettre m répétée deux fois en minuscules) désigne toujours les minutes ; elle ne peut pas être utilisée pour indiquer un jour du mois sur deux chiffres.
|
ss
|
Secondes.
|
Le tableau suivant décrit les formats de nombre pour la fonction.
Code de format
|
Exemple
|
Description
|
#
|
####
|
Renvoie la valeur avec le nombre de chiffres spécifié avec un signe moins à gauche si la valeur est négative.
|
0
|
####.00
|
Renvoie des zéros à gauche. Renvoie des zéros à droite.
|
$
|
$###.00
|
Renvoie la valeur avec un signe dollar à gauche.
|
,
|
#,###
|
Renvoie une virgule à la position spécifiée. Une virgule ne peut pas figurer à droite du signe décimal. Le modèle de format ne doit pas commencer par une virgule.
|
.
|
###.##
|
Renvoie un signe décimal à la position spécifiée. Un seul signe décimal est admis dans le paramètre de format. Si le nombre de chiffres indiqués après le signe décimal est inférieur au nombre de chiffres disponibles après le signe décimal, la décimale est arrondie.
|
Exemples d'utilisation de formats numériques
L'exemple suivant renvoie la valeur 10 :
ToChar (10, '##.##')
L'exemple suivant renvoie la valeur 10 :
ToChar (10, '##.00')
L'exemple suivant renvoie la valeur 10.24 :
ToChar (10.2388, '##.00')
L'exemple suivant renvoie la valeur -10.24 :
ToChar (-10.2388, '##.##')
Exemples d'utilisation de formats de date
L'exemple suivant convertit la valeur renvoyée par la fonction Timestamp() au format JJ/MM/AAAA :
ToChar(Timestamp(),'DD/MM/YYYY')
Par exemple, si la fonction Timestamp() renvoie la valeur 02/29/2008 10:58:37, l'expression précédente est évaluée à 29/02/2008.
Les exemples suivants illustrent l'affichage de minuit dans différents formats :
ToChar(Today(), YYYY/MM/DD hh:mm:ss PM) renvoie la valeur 2009/05/22 12:00:00 AM
ToChar(Today(), YYYY/MM/DD hh:mm:ss) renvoie la valeur 2009/05/22 00:00:00
ToChar(Today(), YYYY/MM/DD hh24:mm:ss PM) renvoie la valeur 2009/05/22 00:00:00
Rubriques connexes
Pour obtenir des informations sur Expression Builder, reportez-vous aux rubriques suivantes :
|