apps-script-utils (Русский) 2.1.1 Help

toInteger

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

Строка читается через parseInt, который берёт ведущие цифры и останавливается: "12abc" даёт 12. Текст без ведущих цифр, пустая строка, null и undefined дают null, то есть неудача — это значение, которое можно проверить, а не расползающийся NaN.

Число проходит насквозь без изменений, в том числе дробное, поэтому toInteger(1.9) — это 1.9, а не 1. Если нужно именно целое, берите Math.trunc или requireInteger.

Параметры

Параметр

Тип

Описание

value

unknown

Значение, из которого читаем.

Возвращает

number | null — число или null, если читать нечего.

Примеры

Чтение числа

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

Смотрите также

Исходный код

src/lang/number/toInteger.ts

23 September 2026

Эта документация сгенерирована нейросетью (Claude) на основе исходного кода библиотеки.