STR (Transact-SQL)

Syntaxe

STR (float_expression [ , length [ ,decimal ] ] )

Arguments

• float_expression
  Expression de type de données numérique approché (float) avec une virgule décimale.

• length
  Longueur totale. Inclut la virgule décimale, le signe, les chiffres et les espaces. La valeur par défaut est 10.

• decimal
  Nombre de décimales (chiffres à droite de la virgule décimale). decimal doit être inférieur ou égal à 16. Si decimal est supérieur à 16, le résultat est tronqué à seize places à droite de la virgule décimale.

Types renvoyés

varchar

Notes

Si elles sont spécifiées, les valeurs des paramètres length et decimal dans STR doivent être positives. Le nombre est arrondi par défaut à un entier ou si le paramètre décimal est 0. La longueur spécifiée doit être supérieure ou égale à la partie du nombre avant la virgule décimale plus le signe du nombre (le cas échéant). Une expression float_expression courte est justifiée à droite dans la longueur spécifiée, et une expression float_expression longue est tronquée après le nombre spécifié de décimales. Par exemple, STR(12**,10) produit le résultat 12. Il est justifié à droite dans le jeu de résultats. Par contre, STR(1223,**2) tronque l'ensemble de résultats à **. Il est possible d'imbriquer des fonctions de chaîne.

Exemples

L'exemple suivant convertit une expression constituée de cinq chiffres et d'une virgule décimale en chaîne de caractères à six positions. La partie fractionnaire du nombre est arrondie à une décimale.

SELECT STR(123.45, 6, 1);
GO

Voici l'ensemble des résultats.

------
 123.5

(1 row(s) affected)

Lorsque l'expression a une longueur supérieure à la longueur spécifiée, la chaîne renvoie ** pour la longueur spécifiée.

SELECT STR(123.45, 2, 2);
GO

Voici l'ensemble des résultats.

--

(1 row(s) affected)

Même lorsque des données numériques sont imbriquées dans STR, le résultat correspond à des données de type caractère avec le format spécifié.

SELECT STR (FLOOR (123.45), 8, 3;)
GO

Voici l'ensemble des résultats.

--------
 123.000

(1 row(s) affected)

Voir aussi

Référence