ee.Number.toInt32

Caste la valeur d'entrée en entier signé de 32 bits.

Utilisation	Renvoie
Number.toInt32()	Nombre

Argument	Type	Détails
ceci : input	Nombre	Valeur d'entrée.

Exemples

Éditeur de code (JavaScript)

// Cast a number to signed 32-bit integer: [-2147483648, 2147483647].
var number = ee.Number(100);
print('Number:', number);

var int32Number = number.toInt32();
print('Number cast to int32:', int32Number);


/**
 * Casting numbers to int32 that are outside of its range and precision can
 * modify the resulting value, note the behavior of the following scenarios.
 */

// A floating point number cast to int32 loses decimal precision.
var float = ee.Number(1.7);
print('Floating point value:', float);

var floatToInt32 = float.toInt32();
print('Floating point value cast to int32:', floatToInt32);

// A number greater than int32 range max cast to int32 becomes int32 range max.
var INT32_MAX = 2147483647;
var outOfRangeHi = ee.Number(INT32_MAX + 12345);
print('Greater than int32 max:', outOfRangeHi);

var outOfRangeHiToInt32 = outOfRangeHi.toInt32();
print('Greater than int32 max cast to int32 becomes int32 max:', outOfRangeHiToInt32);

// A number greater than int32 range min cast to int32 becomes int32 range min.
var INT32_MIN = -2147483648;
var outOfRangeLo = ee.Number(INT32_MIN - 12345);
print('Less than int32 min:', outOfRangeLo);

var outOfRangeLoToInt32 = outOfRangeLo.toInt32();
print('Less than int32 min cast to int32 becomes int32 min:', outOfRangeLoToInt32);

Configuration de Python

Consultez la page Environnement Python pour en savoir plus sur l'API Python et sur l'utilisation de geemap pour le développement interactif.

import ee
import geemap.core as geemap

Colab (Python)

# Cast a number to signed 32-bit integer: [-2147483648, 2147483647].
number = ee.Number(100)
display('Number:', number)

int32_number = number.toInt32()
display('Number cast to int32:', int32_number)


"""Casting numbers to int32 that are outside of its range and precision can
modify the resulting value, note the behavior of the following scenarios.
"""

# A floating point number cast to int32 loses decimal precision.
float_number = ee.Number(1.7)
display('Floating point value:', float_number)

float_to_int32 = float_number.toInt32()
display('Floating point value cast to int32:', float_to_int32)

# A number greater than int32 range max cast to int32 becomes int32 range max.
INT32_MAX = 2147483647
out_of_range_hi = ee.Number(INT32_MAX + 12345)
display('Greater than int32 max:', out_of_range_hi)

out_of_range_hi_to_int32 = out_of_range_hi.toInt32()
display('Greater than int32 max cast to int32 becomes int32 max:',
        out_of_range_hi_to_int32)

# A number greater than int32 range min cast to int32 becomes int32 range min.
INT32_MIN = -2147483648
out_of_range_lo = ee.Number(INT32_MIN - 12345)
display('Less than int32 min:', out_of_range_lo)

out_of_range_lo_to_int32 = out_of_range_lo.toInt32()
display('Less than int32 min cast to int32 becomes int32 min:',
        out_of_range_lo_to_int32)