Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.Number.int32
Stay organized with collections
Save and categorize content based on your preferences.
Casts the input value to a signed 32-bit integer.
Usage | Returns | Number.int32() | Number |
Argument | Type | Details | this: input | Number | The input value. |
Examples
Code Editor (JavaScript)
// Cast a number to signed 32-bit integer: [-2147483648, 2147483647].
var number = ee.Number(100);
print('Number:', number);
var int32Number = number.int32();
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.int32();
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.int32();
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.int32();
print('Less than int32 min cast to int32 becomes int32 min:', outOfRangeLoToInt32);
Python setup
See the
Python Environment page for information on the Python API and using
geemap
for interactive development.
import ee
import geemap.core as geemap
Colab (Python)
# Cast a number to signed 32-bit integer: [-2147483648, 2147483647].
number = ee.Number(100)
print('Number:', number.getInfo())
int32_number = number.int32()
print('Number cast to int32:', int32_number.getInfo())
"""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)
print('Floating point value:', float_number.getInfo())
float_to_int32 = float_number.int32()
print('Floating point value cast to int32:', float_to_int32.getInfo())
# 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)
print('Greater than int32 max:', out_of_range_hi.getInfo())
out_of_range_hi_to_int32 = out_of_range_hi.int32()
print('Greater than int32 max cast to int32 becomes int32 max:',
out_of_range_hi_to_int32.getInfo())
# 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)
print('Less than int32 min:', out_of_range_lo.getInfo())
out_of_range_lo_to_int32 = out_of_range_lo.int32()
print('Less than int32 min cast to int32 becomes int32 min:',
out_of_range_lo_to_int32.getInfo())
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2023-10-06 UTC.
[null,null,["Last updated 2023-10-06 UTC."],[[["\u003cp\u003e\u003ccode\u003eNumber.int32()\u003c/code\u003e casts a given Number input to a signed 32-bit integer within the range of -2147483648 to 2147483647.\u003c/p\u003e\n"],["\u003cp\u003eValues exceeding this range are clamped to the minimum or maximum int32 value.\u003c/p\u003e\n"],["\u003cp\u003eWhen casting floating-point numbers, the decimal portion is truncated, resulting in a loss of precision.\u003c/p\u003e\n"]]],["The `int32()` method casts a given number to a signed 32-bit integer, with a range of -2147483648 to 2147483647. Floating-point numbers lose decimal precision when cast. Numbers exceeding the maximum range become the maximum value (2147483647), while numbers below the minimum become the minimum value (-2147483648). The method takes a number as input and returns the converted integer.\n"],null,["# ee.Number.int32\n\nCasts the input value to a signed 32-bit integer.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|------------------|---------|\n| Number.int32`()` | Number |\n\n| Argument | Type | Details |\n|---------------|--------|------------------|\n| this: `input` | Number | The input value. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// Cast a number to signed 32-bit integer: [-2147483648, 2147483647].\nvar number = ee.Number(100);\nprint('Number:', number);\n\nvar int32Number = number.int32();\nprint('Number cast to int32:', int32Number);\n\n\n/**\n * Casting numbers to int32 that are outside of its range and precision can\n * modify the resulting value, note the behavior of the following scenarios.\n */\n\n// A floating point number cast to int32 loses decimal precision.\nvar float = ee.Number(1.7);\nprint('Floating point value:', float);\n\nvar floatToInt32 = float.int32();\nprint('Floating point value cast to int32:', floatToInt32);\n\n// A number greater than int32 range max cast to int32 becomes int32 range max.\nvar INT32_MAX = 2147483647;\nvar outOfRangeHi = ee.Number(INT32_MAX + 12345);\nprint('Greater than int32 max:', outOfRangeHi);\n\nvar outOfRangeHiToInt32 = outOfRangeHi.int32();\nprint('Greater than int32 max cast to int32 becomes int32 max:', outOfRangeHiToInt32);\n\n// A number greater than int32 range min cast to int32 becomes int32 range min.\nvar INT32_MIN = -2147483648;\nvar outOfRangeLo = ee.Number(INT32_MIN - 12345);\nprint('Less than int32 min:', outOfRangeLo);\n\nvar outOfRangeLoToInt32 = outOfRangeLo.int32();\nprint('Less than int32 min cast to int32 becomes int32 min:', outOfRangeLoToInt32);\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\n### Colab (Python)\n\n```python\n# Cast a number to signed 32-bit integer: [-2147483648, 2147483647].\nnumber = ee.Number(100)\nprint('Number:', number.getInfo())\n\nint32_number = number.int32()\nprint('Number cast to int32:', int32_number.getInfo())\n\n\n\"\"\"Casting numbers to int32 that are outside of its range and precision can\nmodify the resulting value, note the behavior of the following scenarios.\n\"\"\"\n\n# A floating point number cast to int32 loses decimal precision.\nfloat_number = ee.Number(1.7)\nprint('Floating point value:', float_number.getInfo())\n\nfloat_to_int32 = float_number.int32()\nprint('Floating point value cast to int32:', float_to_int32.getInfo())\n\n# A number greater than int32 range max cast to int32 becomes int32 range max.\nINT32_MAX = 2147483647\nout_of_range_hi = ee.Number(INT32_MAX + 12345)\nprint('Greater than int32 max:', out_of_range_hi.getInfo())\n\nout_of_range_hi_to_int32 = out_of_range_hi.int32()\nprint('Greater than int32 max cast to int32 becomes int32 max:',\n out_of_range_hi_to_int32.getInfo())\n\n# A number greater than int32 range min cast to int32 becomes int32 range min.\nINT32_MIN = -2147483648\nout_of_range_lo = ee.Number(INT32_MIN - 12345)\nprint('Less than int32 min:', out_of_range_lo.getInfo())\n\nout_of_range_lo_to_int32 = out_of_range_lo.int32()\nprint('Less than int32 min cast to int32 becomes int32 min:',\n out_of_range_lo_to_int32.getInfo())\n```"]]