ee.Number.toInt16
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Truyền giá trị đầu vào thành số nguyên 16 bit có dấu.
Cách sử dụng | Giá trị trả về |
---|
Number.toInt16() | Số |
Đối số | Loại | Thông tin chi tiết |
---|
this: input | Số | Giá trị đầu vào. |
Ví dụ
Trình soạn thảo mã (JavaScript)
// Cast a number to signed 16-bit integer: [-32768, 32767].
var number = ee.Number(100);
print('Number:', number);
var int16Number = number.toInt16();
print('Number cast to int16:', int16Number);
/**
* Casting numbers to int16 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 int16 loses decimal precision.
var float = ee.Number(1.7);
print('Floating point value:', float);
var floatToInt16 = float.toInt16();
print('Floating point value cast to int16:', floatToInt16);
// A number greater than int16 range max cast to int16 becomes int16 range max.
var INT16_MAX = 32767;
var outOfRangeHi = ee.Number(INT16_MAX + 12345);
print('Greater than int16 max:', outOfRangeHi);
var outOfRangeHiToInt16 = outOfRangeHi.toInt16();
print('Greater than int16 max cast to int16 becomes int16 max:', outOfRangeHiToInt16);
// A number greater than int16 range min cast to int16 becomes int16 range min.
var INT16_MIN = -32768;
var outOfRangeLo = ee.Number(INT16_MIN - 12345);
print('Less than int16 min:', outOfRangeLo);
var outOfRangeLoToInt16 = outOfRangeLo.toInt16();
print('Less than int16 min cast to int16 becomes int16 min:', outOfRangeLoToInt16);
Thiết lập Python
Hãy xem trang
Môi trường Python để biết thông tin về API Python và cách sử dụng geemap
cho quá trình phát triển tương tác.
import ee
import geemap.core as geemap
Colab (Python)
# Cast a number to signed 16-bit integer: [-32768, 32767].
number = ee.Number(100)
print('Number:', number.getInfo())
int16_number = number.toInt16()
print('Number cast to int16:', int16_number.getInfo())
"""Casting numbers to int16 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 int16 loses decimal precision.
float_number = ee.Number(1.7)
print('Floating point value:', float_number.getInfo())
float_to_int16 = float_number.toInt16()
print('Floating point value cast to int16:', float_to_int16.getInfo())
# A number greater than int16 range max cast to int16 becomes int16 range max.
INT16_MAX = 32767
out_of_range_hi = ee.Number(INT16_MAX + 12345)
print('Greater than int16 max:', out_of_range_hi.getInfo())
out_of_range_hi_to_int16 = out_of_range_hi.toInt16()
print('Greater than int16 max cast to int16 becomes int16 max:',
out_of_range_hi_to_int16.getInfo())
# A number greater than int16 range min cast to int16 becomes int16 range min.
INT16_MIN = -32768
out_of_range_lo = ee.Number(INT16_MIN - 12345)
print('Less than int16 min:', out_of_range_lo.getInfo())
out_of_range_lo_to_int16 = out_of_range_lo.toInt16()
print('Less than int16 min cast to int16 becomes int16 min:',
out_of_range_lo_to_int16.getInfo())
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-26 UTC."],[[["\u003cp\u003e\u003ccode\u003eNumber.toInt16()\u003c/code\u003e casts a given number to a signed 16-bit integer, effectively constraining its value within the range of -32768 to 32767.\u003c/p\u003e\n"],["\u003cp\u003eValues exceeding the maximum limit of this range are truncated to the maximum value (32767), and those below the minimum are set to the minimum value (-32768).\u003c/p\u003e\n"],["\u003cp\u003eCasting floating-point numbers using this function results in a loss of decimal precision, as it retains only the integer portion.\u003c/p\u003e\n"]]],[],null,["# ee.Number.toInt16\n\nCasts the input value to a signed 16-bit integer.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|--------------------|---------|\n| Number.toInt16`()` | 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 16-bit integer: [-32768, 32767].\nvar number = ee.Number(100);\nprint('Number:', number);\n\nvar int16Number = number.toInt16();\nprint('Number cast to int16:', int16Number);\n\n\n/**\n * Casting numbers to int16 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 int16 loses decimal precision.\nvar float = ee.Number(1.7);\nprint('Floating point value:', float);\n\nvar floatToInt16 = float.toInt16();\nprint('Floating point value cast to int16:', floatToInt16);\n\n// A number greater than int16 range max cast to int16 becomes int16 range max.\nvar INT16_MAX = 32767;\nvar outOfRangeHi = ee.Number(INT16_MAX + 12345);\nprint('Greater than int16 max:', outOfRangeHi);\n\nvar outOfRangeHiToInt16 = outOfRangeHi.toInt16();\nprint('Greater than int16 max cast to int16 becomes int16 max:', outOfRangeHiToInt16);\n\n// A number greater than int16 range min cast to int16 becomes int16 range min.\nvar INT16_MIN = -32768;\nvar outOfRangeLo = ee.Number(INT16_MIN - 12345);\nprint('Less than int16 min:', outOfRangeLo);\n\nvar outOfRangeLoToInt16 = outOfRangeLo.toInt16();\nprint('Less than int16 min cast to int16 becomes int16 min:', outOfRangeLoToInt16);\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 16-bit integer: [-32768, 32767].\nnumber = ee.Number(100)\nprint('Number:', number.getInfo())\n\nint16_number = number.toInt16()\nprint('Number cast to int16:', int16_number.getInfo())\n\n\n\"\"\"Casting numbers to int16 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 int16 loses decimal precision.\nfloat_number = ee.Number(1.7)\nprint('Floating point value:', float_number.getInfo())\n\nfloat_to_int16 = float_number.toInt16()\nprint('Floating point value cast to int16:', float_to_int16.getInfo())\n\n# A number greater than int16 range max cast to int16 becomes int16 range max.\nINT16_MAX = 32767\nout_of_range_hi = ee.Number(INT16_MAX + 12345)\nprint('Greater than int16 max:', out_of_range_hi.getInfo())\n\nout_of_range_hi_to_int16 = out_of_range_hi.toInt16()\nprint('Greater than int16 max cast to int16 becomes int16 max:',\n out_of_range_hi_to_int16.getInfo())\n\n# A number greater than int16 range min cast to int16 becomes int16 range min.\nINT16_MIN = -32768\nout_of_range_lo = ee.Number(INT16_MIN - 12345)\nprint('Less than int16 min:', out_of_range_lo.getInfo())\n\nout_of_range_lo_to_int16 = out_of_range_lo.toInt16()\nprint('Less than int16 min cast to int16 becomes int16 min:',\n out_of_range_lo_to_int16.getInfo())\n```"]]