ee.Number.int8
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Wandelt den Eingabewert in eine vorzeichenbehaftete 8‑Bit-Ganzzahl um.
Nutzung | Ausgabe |
---|
Number.int8() | Zahl |
Argument | Typ | Details |
---|
So gehts: input | Zahl | Der Eingabewert. |
Beispiele
Code-Editor (JavaScript)
// Cast a number to signed 8-bit integer: [-128, 127].
var number = ee.Number(100);
print('Number:', number);
var int8Number = number.int8();
print('Number cast to int8:', int8Number);
/**
* Casting numbers to int8 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 int8 loses decimal precision.
var float = ee.Number(1.7);
print('Floating point value:', float);
var floatToInt8 = float.int8();
print('Floating point value cast to int8:', floatToInt8);
// A number greater than int8 range max cast to int8 becomes int8 range max.
var INT8_MAX = 127;
var outOfRangeHi = ee.Number(INT8_MAX + 12345);
print('Greater than int8 max:', outOfRangeHi);
var outOfRangeHiToInt8 = outOfRangeHi.int8();
print('Greater than int8 max cast to int8 becomes int8 max:', outOfRangeHiToInt8);
// A number greater than int8 range min cast to int8 becomes int8 range min.
var INT8_MIN = -128;
var outOfRangeLo = ee.Number(INT8_MIN - 12345);
print('Less than int8 min:', outOfRangeLo);
var outOfRangeLoToInt8 = outOfRangeLo.int8();
print('Less than int8 min cast to int8 becomes int8 min:', outOfRangeLoToInt8);
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 8-bit integer: [-128, 127].
number = ee.Number(100)
print('Number:', number.getInfo())
int8_number = number.int8()
print('Number cast to int8:', int8_number.getInfo())
"""Casting numbers to int8 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 int8 loses decimal precision.
float_number = ee.Number(1.7)
print('Floating point value:', float_number.getInfo())
float_to_int8 = float_number.int8()
print('Floating point value cast to int8:', float_to_int8.getInfo())
# A number greater than int8 range max cast to int8 becomes int8 range max.
INT8_MAX = 127
out_of_range_hi = ee.Number(INT8_MAX + 12345)
print('Greater than int8 max:', out_of_range_hi.getInfo())
out_of_range_hi_to_int8 = out_of_range_hi.int8()
print('Greater than int8 max cast to int8 becomes int8 max:',
out_of_range_hi_to_int8.getInfo())
# A number greater than int8 range min cast to int8 becomes int8 range min.
INT8_MIN = -128
out_of_range_lo = ee.Number(INT8_MIN - 12345)
print('Less than int8 min:', out_of_range_lo.getInfo())
out_of_range_lo_to_int8 = out_of_range_lo.int8()
print('Less than int8 min cast to int8 becomes int8 min:',
out_of_range_lo_to_int8.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.int8()\u003c/code\u003e casts a given number to a signed 8-bit integer, which can represent values between -128 and 127.\u003c/p\u003e\n"],["\u003cp\u003eCasting floating point numbers to int8 using this method results in the loss of decimal precision, effectively truncating the decimal portion.\u003c/p\u003e\n"],["\u003cp\u003eIf the input number exceeds the maximum value for an int8 (127), the result will be capped at 127.\u003c/p\u003e\n"],["\u003cp\u003eIf the input number is less than the minimum value for an int8 (-128), the result will be capped at -128.\u003c/p\u003e\n"]]],[],null,["# ee.Number.int8\n\nCasts the input value to a signed 8-bit integer.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-----------------|---------|\n| Number.int8`()` | 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 8-bit integer: [-128, 127].\nvar number = ee.Number(100);\nprint('Number:', number);\n\nvar int8Number = number.int8();\nprint('Number cast to int8:', int8Number);\n\n\n/**\n * Casting numbers to int8 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 int8 loses decimal precision.\nvar float = ee.Number(1.7);\nprint('Floating point value:', float);\n\nvar floatToInt8 = float.int8();\nprint('Floating point value cast to int8:', floatToInt8);\n\n// A number greater than int8 range max cast to int8 becomes int8 range max.\nvar INT8_MAX = 127;\nvar outOfRangeHi = ee.Number(INT8_MAX + 12345);\nprint('Greater than int8 max:', outOfRangeHi);\n\nvar outOfRangeHiToInt8 = outOfRangeHi.int8();\nprint('Greater than int8 max cast to int8 becomes int8 max:', outOfRangeHiToInt8);\n\n// A number greater than int8 range min cast to int8 becomes int8 range min.\nvar INT8_MIN = -128;\nvar outOfRangeLo = ee.Number(INT8_MIN - 12345);\nprint('Less than int8 min:', outOfRangeLo);\n\nvar outOfRangeLoToInt8 = outOfRangeLo.int8();\nprint('Less than int8 min cast to int8 becomes int8 min:', outOfRangeLoToInt8);\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 8-bit integer: [-128, 127].\nnumber = ee.Number(100)\nprint('Number:', number.getInfo())\n\nint8_number = number.int8()\nprint('Number cast to int8:', int8_number.getInfo())\n\n\n\"\"\"Casting numbers to int8 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 int8 loses decimal precision.\nfloat_number = ee.Number(1.7)\nprint('Floating point value:', float_number.getInfo())\n\nfloat_to_int8 = float_number.int8()\nprint('Floating point value cast to int8:', float_to_int8.getInfo())\n\n# A number greater than int8 range max cast to int8 becomes int8 range max.\nINT8_MAX = 127\nout_of_range_hi = ee.Number(INT8_MAX + 12345)\nprint('Greater than int8 max:', out_of_range_hi.getInfo())\n\nout_of_range_hi_to_int8 = out_of_range_hi.int8()\nprint('Greater than int8 max cast to int8 becomes int8 max:',\n out_of_range_hi_to_int8.getInfo())\n\n# A number greater than int8 range min cast to int8 becomes int8 range min.\nINT8_MIN = -128\nout_of_range_lo = ee.Number(INT8_MIN - 12345)\nprint('Less than int8 min:', out_of_range_lo.getInfo())\n\nout_of_range_lo_to_int8 = out_of_range_lo.int8()\nprint('Less than int8 min cast to int8 becomes int8 min:',\n out_of_range_lo_to_int8.getInfo())\n```"]]