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

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'à 28 chiffres en chaînes. Si vous transmettez une valeur décimale de plus de 28 chiffres, l'expression TO_CHAR renvoie une notation scientifique pour les nombres de plus de 28 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
(greater than 28)
'1.23456789012346e+028'