Imprimer      Ouvrir la version PDF de l'aide en ligne


Rubrique précédente

Rubrique suivante

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 :


Publié en octobre 2016 Copyright © 2005, 2016, Oracle. Tous droits réservés. Legal Notices.