ee.Number.int16
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
مقدار ورودی را به یک عدد صحیح 16 بیتی امضا شده ارسال می کند.
استفاده | برمی گرداند | Number. int16 () | شماره |
استدلال | تایپ کنید | جزئیات | این: input | شماره | مقدار ورودی |
نمونه ها
ویرایشگر کد (جاوا اسکریپت)
// Cast a number to signed 16-bit integer: [-32768, 32767].
var number = ee.Number(100);
print('Number:', number);
var int16Number = number.int16();
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.int16();
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.int16();
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.int16();
print('Less than int16 min cast to int16 becomes int16 min:', outOfRangeLoToInt16);
راه اندازی پایتون
برای اطلاعات در مورد API پایتون و استفاده از geemap
برای توسعه تعاملی به صفحه محیط پایتون مراجعه کنید.
import ee
import geemap.core as geemap
کولب (پایتون)
# Cast a number to signed 16-bit integer: [-32768, 32767].
number = ee.Number(100)
print('Number:', number.getInfo())
int16_number = number.int16()
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.int16()
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.int16()
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.int16()
print('Less than int16 min cast to int16 becomes int16 min:',
out_of_range_lo_to_int16.getInfo())
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003e\u003ccode\u003eNumber.int16()\u003c/code\u003e casts a given input number to a signed 16-bit integer, within the range of -32768 to 32767.\u003c/p\u003e\n"],["\u003cp\u003eWhen casting a floating-point number, the decimal precision is lost, resulting in the integer part of the number.\u003c/p\u003e\n"],["\u003cp\u003eNumbers exceeding the maximum value of the signed 16-bit integer range are converted to the maximum value (32767).\u003c/p\u003e\n"],["\u003cp\u003eConversely, numbers falling below the minimum value of the signed 16-bit integer range are converted to the minimum value (-32768).\u003c/p\u003e\n"]]],["The `int16()` method casts a number to a signed 16-bit integer, with a range of -32768 to 32767. Input values outside this range are clamped to the range's minimum or maximum. Floating-point numbers lose decimal precision during the cast. The method takes an input `Number` and returns a `Number` of the signed int16 type.\n"],null,["# ee.Number.int16\n\nCasts the input value to a signed 16-bit integer.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|------------------|---------|\n| Number.int16`()` | 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.int16();\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.int16();\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.int16();\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.int16();\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.int16()\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.int16()\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.int16()\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.int16()\nprint('Less than int16 min cast to int16 becomes int16 min:',\n out_of_range_lo_to_int16.getInfo())\n```"]]