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 (Nombres)

TO_CHAR (Nombres)

Convertit des valeurs numériques en chaînes de texte. TO_CHAR convertit également des dates en chaînes.
TO_CHAR convertit des valeurs doubles en chaînes de texte comme suit :
  • Convertit des valeurs doubles contenant jusqu'à 16 chiffres en chaînes et fournit une précision allant jusqu'à 15 chiffres. Si vous transmettez un nombre comportant plus de 15 chiffres, l'expression TO_CHAR l'arrondit en fonction du seizième chiffre et renvoie la représentation de chaîne du nombre en notation scientifique. Par exemple, la valeur double 1234567890123456 est convertie en valeur de chaîne « 1,23456789012346e + 015 ».
  • Renvoie une notation décimale pour des nombres compris dans les plages (-1e16, -1e-16] et [1e-16, 1e16). L'expression TO_CHAR renvoie une notation scientifique pour les nombres hors de ces plages. Par exemple, la valeur double 10842764968208837340 est convertie en valeur de chaîne « 1,08427649682088e + 019 ».
L'expression TO_CHAR convertit des valeurs décimales en chaînes de texte comme suit :
  • En mode de précision élevée, l'expression TO_CHAR convertit les valeurs décimales jusqu'à 38 chiffres en chaînes. Si vous transmettez une valeur décimale de plus de 38 chiffres, l'expression TO_CHAR renvoie une notation scientifique pour les nombres de plus de 38 chiffres.
  • En mode de précision faible, l'expression TO_CHAR traite les valeurs décimales comme des valeurs doubles.

Syntaxe

TO_CHAR(
numeric_value
)
Le tableau suivant décrit l'argument de cette commande :
Argument
Obligatoire/
Facultatif
Description
numeric_value
Requis
Type de données numériques. Valeur numérique à convertir en chaîne. Vous pouvez entrer l'expression de transformation valide de votre choix.

Valeur de retour

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

Exemple de conversion double

L'expression suivante convertit les valeurs doubles du port SALES en chaînes :
TO_CHAR( SALES )
SALES
RETURN VALUE
1010.99
'1010.99'
-15.62567
'-15.62567'
10842764968208837340
'1.08427649682088e+019'
  (rounded based on the 16th digit and returns the value in scientific notation)
236789034569723
'236789034569723'
0
'0'
33.15
'33.15'
NULL
NULL

Exemple de conversion décimale

En mode de précision élevée, l'expression suivante convertit les valeurs décimales du port SALES en chaînes :
TO_CHAR( SALES )
SALES
RETURN VALUE
2378964536789761
'2378964536789761'
1234567890123456789012345679
'1234567890123456789012345679'
1.234578945469649345876123456
'1.234578945469649345876123456'
0.999999999999999999999999999
'0.999999999999999999999999999'
12345678901234567890123456799
'12345678901234567890123456799'
23456788992233456678458934567123465239
'23456788992233456678458934567123465239'
423456789012345678901234567991234567899
(supérieur à 38)
'4.23456789012346e+038'