WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Number.prototype.toString(radix): Zahlen zur gewählten Basis darstellen

Wandle einen `Number`-Wert in Text zur Basis 2 bis 36 um. Erfahre, wie JavaScript die Basis bestimmt und umwandelt und warum Formatieren nicht dasselbe ist wie das Einlesen von Text.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

number.toString()
number.toString(radix)

Number.prototype.toString(radix) gibt eine Zeichenkette zurück, ohne die Zahl zu ändern. radix ist die Basis des Zahlensystems: 2 steht für binär, 16 für hexadezimal. Fehlt das Argument oder ist es undefined, gilt Basis 10. Der this-Wert muss ein primitiver Number-Wert oder ein Number-Objekt sein. Andere Werte, etwa Zeichenketten, führen zu einem TypeError.

Nach ECMAScript 2024 wird eine angegebene Basis in einen Number-Wert umgewandelt. Ein endlicher Wert mit Nachkommastellen wird in Richtung null abgeschnitten; "16.9" ergibt also Basis 16. Liegt die so ermittelte Basis nicht zwischen 2 und 36 einschließlich, entsteht ein RangeError. Das gilt auch für null und NaN (beide werden zu null) sowie für Unendlichkeiten. Ein Symbol- oder BigInt-Argument führt bei der Umwandlung zu einem TypeError.

Die Ausgabe nutzt die Ziffern 0–9 und danach die Kleinbuchstaben a–z, ohne ein Präfix wie 0b oder 0x hinzuzufügen. Ein führendes - ist ein Vorzeichen, keine Zweierkomplementdarstellung; . trennt den Nachkommateil ab. +0 und -0 ergeben beide "0"; Sonderwerte ergeben "NaN", "Infinity" und "-Infinity". Bei Basis 10 ist Exponentialschreibweise möglich, etwa "1e+21".

Ein Basiswechsel stellt keine Genauigkeit wieder her, die im Number-Wert bereits verloren ging. Die letzte signifikante Stelle ist nicht immer eindeutig festgelegt; rechne daher nicht in jeder Engine mit derselben Zeichenkette. Verwende für große Ganzzahlen, die exakt bleiben müssen, von Anfang an BigInt und rufe BigInt.prototype.toString auf. parseInt(text, radix) liest einen ganzzahligen Anfangsteil, prüft aber nicht die gesamte Zeichenkette und stellt keine Nachkommastellen wieder her: parseInt("ff!", 16) ergibt 255.

Beispiele

{
  const n = 255;
  console.log(n.toString());
  console.log(n.toString(2));
  console.log(n.toString(16));
  console.log(n.toString("16.9"));
  console.log((-10.5).toString(2));
  console.log(parseInt(n.toString(16), 16));

  try {
    n.toString(37);
  } catch (error) {
    console.log(error.name);
  }
}

Ergebnis

255
11111111
ff
ff
-1010.1
255
RangeError

Dieselbe Zahl erscheint dezimal, binär und hexadezimal. `"16.9"` wählt Basis `16`, die negative Zahl mit Nachkommastelle behält ihr Vorzeichen, und Basis `37` führt zu einem `RangeError`.

Zugehörige Lektionen

  • JavaScript · Lektion 2 · Fortgeschritten · Version: 4
  • JavaScript · Lektion 3 · Fortgeschritten · Version: 4

Quellen