Number.prototype.toString()

La méthode toString() renvoie une chaîne de caractère représentant l'objet Number.

Syntaxe

numObj.toString([base])

Paramètre

base
Paramè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'objet Number.

Exception

RangeError

Si toString() reçoit une base qui n'est pas comprise entre 2 et 36, une exception RangeError est levée.

Description

L'objet Number surcharge la méthode toString() de Object et n'hérite donc pas de Object.prototype.toString(). Pour les objets Number, la méthode toString() renvoie une représentation du nombre, dans une base donnée, en une chaîne de caractères.

La méthode toString() 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 lettres a à f sont utilisées.

Si la base n'est pas spécifiée, on utilisera la base 10 par défaut.

Si l'objet Number 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ésentation n'est pas le complément à deux du nombre.

Si l'objet Number n'est pas un nombre entier, le point (.) sera utilisé pour séparer la partie entière et décimale.

Exemples

Utiliser toString

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

Spécification État Commentaires
ECMAScript 1st Edition (ECMA-262) Standard Définition initiale. Implémentée par JavaScript 1.1.
ECMAScript 5.1 (ECMA-262)
La définition de 'Number.prototype.tostring' dans cette spécification.		 Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'Number.prototype.tostring' dans cette spécification.		 Standard  
ECMAScript Latest Draft (ECMA-262)
La définition de 'Number.prototype.tostring' dans cette spécification.		 Projet  

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobileServeur
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung InternetNode.js
toStringChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 3Opera Support complet OuiSafari Support complet 1WebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet 1Samsung Internet Android Support complet 1.0nodejs Support complet Oui

Légende

Support complet  
Support complet

Voir aussi

Sujets associés
  1. Objets standards
  2. Number
  3. Propriétés
    1. Number.EPSILON
    2. Number.MAX_SAFE_INTEGER
    3. Number.MAX_VALUE
    4. Number.MIN_SAFE_INTEGER
    5. Number.MIN_VALUE
    6. Number.NEGATIVE_INFINITY
    7. Number.NaN
    8. Number.POSITIVE_INFINITY
    9. Number.prototype
  4. Méthodes
    1. Number.isFinite()
    2. Number.isInteger()
    3. Number.isNaN()
    4. Number.isSafeInteger()
    5. Number.parseFloat()
    6. Number.parseInt()
    7. Number.prototype.toExponential()
    8. Number.prototype.toFixed()
    9. Number.prototype.toLocaleString()
    10. Number.prototype.toPrecision()
    11. Number.prototype.toSource()
    12. Number.prototype.toString()
    13. Number.prototype.valueOf()
    14. Number.toInteger()
  5. Héritage :
  6. Function
  7. Propriétés
    1. Function.arguments
    2. Function.arity
    3. Function.caller
    4. Function.displayName
    5. Function.length
    6. Function.name
    7. Function.prototype
  8. Méthodes
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.isGenerator()
    5. Function.prototype.toSource()
    6. Function.prototype.toString()
  9. Object
  10. Propriétés
    1. Object.prototype.__count__
    2. Object.prototype.__noSuchMethod__
    3. Object.prototype.__parent__
    4. Object.prototype.__proto__
    5. Object.prototype.constructor
  11. Méthodes
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toSource()
    10. Object.prototype.toString()
    11. Object.prototype.unwatch()
    12. Object.prototype.valueOf()
    13. Object.prototype.watch()
    14. Object.setPrototypeOf()