apps-script-utils (Deutsch) 2.1.1 Help

toInteger

function toInteger(value: unknown): number | null;

Eine Zeichenkette wird mit parseInt gelesen, das die führenden Ziffern nimmt und dann aufhört: "12abc" ergibt 12. Text ohne führende Ziffern, die leere Zeichenkette, null und undefined ergeben null — das Scheitern ist also ein prüfbarer Wert und kein sich ausbreitendes NaN.

Eine Zahl geht unverändert durch, auch eine gebrochene: toInteger(1.9) ist 1.9, nicht 1. Wird wirklich eine ganze Zahl gebraucht, nehmen Sie Math.trunc oder requireInteger.

Parameter

Parameter

Typ

Beschreibung

value

unknown

Der zu lesende Wert.

Rückgabewert

number | null — die Zahl oder null, wenn nichts zu lesen ist.

Beispiele

Eine Zahl lesen

toInteger(" 42 "); // => 42 toInteger("12abc"); // => 12 toInteger("abc"); // => null toInteger(null); // => null toInteger(1.9); // => 1.9

Siehe auch

Quellcode

src/lang/number/toInteger.ts

23 September 2026

Diese Dokumentation wurde mit KI (Claude) aus dem Quellcode der Bibliothek erzeugt.