ee.Number.int32
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Wandelt den Eingabewert in eine vorzeichenbehaftete 32‑Bit-Ganzzahl um.
Nutzung | Ausgabe |
---|
Number.int32() | Zahl |
Argument | Typ | Details |
---|
So gehts: input | Zahl | Der Eingabewert. |
Beispiele
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 einrichten
Informationen zur Python API und zur Verwendung von geemap
für die interaktive Entwicklung finden Sie auf der Seite
Python-Umgebung.
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())
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-26 (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```"]]