WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Math.trunc: Ganzzahlanteil in Richtung null

Math.trunc wandelt sein Argument in Number um und entfernt den Bruchteil, also rundet es in Richtung null.

Version: ECMAScript 2015 onward; example target: Node.js 24.22.2

Syntax

Math.trunc(x)

Math.trunc(x) wendet ToNumber an und liefert den ganzzahligen Anteil eines endlichen x: Aus 3.9 wird 3, aus -3.9 wird -3. Ist die Number bereits ganzzahlig, wird sie unverändert zurückgegeben, einschließlich +0 und -0. Das Ergebnis bleibt eine Number und erhält daher keine beliebige Genauigkeit.

NaN und ein fehlendes Argument ergeben NaN; Infinity und -Infinity werden unverändert zurückgegeben. Eine numerische Zeichenkette wird umgewandelt; Symbol oder BigInt löst TypeError aus, und eine Objektumwandlung kann Benutzercode ausführen. Ein negativer Bruch zwischen -1 und 0 ergibt -0, erkennbar mit Object.is; vor dem Abschneiden ist die Eingabe bereits ein gerundeter binary64-Wert.

Die Methode existiert seit ECMAScript 2015 und ist kein Konstruktor. Das Beispiel wandelt 9876 Millisekunden in 9 volle Sekunden um und zeigt Konvertierung sowie -0. Verwende weder parseInt zum Abschneiden von Zahlen noch bitweise Operationen, die auf 32 Bit konvertieren; für exakte große Ganzzahlen eignet sich BigInt-Arithmetik statt Math.trunc.

Beispiele

const milliseconds = 9876;
console.log(Math.trunc(milliseconds / 1000));
console.log(Math.trunc(3.9), Math.trunc(-3.9));
console.log(Object.is(Math.trunc(-0.25), -0));
console.log(Math.trunc("12.8"));
try { Math.trunc(1n); } catch (error) { console.log(error instanceof TypeError); }

Ergebnis

9
3 -3
true
12
true

Math.trunc → volle Sekunden, Zeichenkettenumwandlung, negative null und BigInt-TypeError

Quellen