apps-script-utils (Français) 2.1.1 Help

toInteger

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

Une chaîne est lue par parseInt, qui prend les chiffres de tête et s'arrête : "12abc" donne 12. Un texte sans chiffre initial, la chaîne vide, null et undefined donnent null: l'échec est donc une valeur vérifiable, pas un NaN qui se propage.

Un nombre passe intact, y compris fractionnaire : toInteger(1.9) vaut 1.9, pas 1. Utilisez Math.trunc ou requireInteger lorsqu'un entier est réellement attendu.

Paramètres

Paramètre

Type

Description

value

unknown

La valeur à lire.

Valeur de retour

number | null — le nombre, ou null s'il n'y a rien à lire.

Exemples

Lire un nombre

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

Voir aussi

Code source

src/lang/number/toInteger.ts

23 September 2026

Cette documentation a été générée par une IA (Claude) à partir du code source de la bibliothèque.