Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
Number.prototype.toString()
Baseline Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La méthodetoString() renvoie une chaîne de caractère représentant l'objet Number.
Dans cet article
Exemple interactif
function hexColour(c) { if (c < 256) { return Math.abs(c).toString(16); } return 0;}console.log(hexColour(233));// Expected output: "e9"console.log(hexColour("11"));// Expected output: "b"Syntaxe
numObj.toString([base]);Paramètre
baseParamètre optionnel. Un entier compris entre 2 et 36 qui indique la base du système numérique à utiliser pour représenter la valeur.
Valeur de retour
Une chaîne de caractères représentant l'objetNumber.
Exception
RangeErrorSi
toString()reçoit une base qui n'est pas comprise entre 2 et 36, une exceptionRangeErrorest levée.
Description
L'objetNumber surcharge la méthodetoString() deObject et n'hérite donc pas deObject.prototype.toString(). Pour les objetsNumber, la méthodetoString() renvoie une représentation du nombre, dans une base donnée, en une chaîne de caractères.
La méthodetoString() analyse son premier argument et tente de renvoyer une chaîne de caractères représentant le nombre en une base donnée. Pour les bases supérieures à 10, les lettres de l'alphabet sont utilisées pour représenter les numéraux supérieurs à 9. Par exemple, pour les nombres hexadécimaux (en base 16), les lettresa àf sont utilisées.
Si la base n'est pas spécifiée, on utilisera la base 10 par défaut.
Si l'objetNumber est négatif, le signe sera conservé. Ceci, même si la base utilisée est la base 2 : la chaîne de caractères rendue sera la représentation binaire du nombre positif précédée par un signe -. La représentationn'est pas le complément à deux du nombre.
Si l'objetNumber n'est pas un nombre entier, le point (.) sera utilisé pour séparer la partie entière et décimale.
Exemples
>UtilisertoString
var compte = 10;console.log(compte.toString()); // affiche "10"console.log((17).toString()); // affiche "17"console.log((17.2).toString()); // affiche "17.2"var x = 6;console.log(x.toString(2)); // affiche "110"console.log((254).toString(16)); // affiche "fe"console.log((-10).toString(2)); // affiche "-1010"console.log((-0xff).toString(2)); // affiche "-11111111"Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification> # sec-number.prototype.tostring> |