إشعار: يجب
إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.
ee.Number.int
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تحوّل قيمة الإدخال إلى عدد صحيح 32 بت يحمل علامة.
الاستخدام | المرتجعات |
---|
Number.int() | العدد |
الوسيطة | النوع | التفاصيل |
---|
هذا: input | العدد | تمثّل هذه السمة قيمة الإدخال. |
أمثلة
محرّر الرموز البرمجية (JavaScript)
// Cast a number to signed 32-bit integer: [-2147483648, 2147483647].
var number = ee.Number(100);
print('Number:', number);
var intNumber = number.int();
print('Number cast to int:', intNumber);
/**
* Casting numbers to int 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 int loses decimal precision.
var float = ee.Number(1.7);
print('Floating point value:', float);
var floatToInt = float.int();
print('Floating point value cast to int:', floatToInt);
// A number greater than int range max cast to int becomes int range max.
var INT_MAX = 2147483647;
var outOfRangeHi = ee.Number(INT_MAX + 12345);
print('Greater than int max:', outOfRangeHi);
var outOfRangeHiToInt = outOfRangeHi.int();
print('Greater than int max cast to int becomes int max:', outOfRangeHiToInt);
// A number greater than int range min cast to int becomes int range min.
var INT_MIN = -2147483648;
var outOfRangeLo = ee.Number(INT_MIN - 12345);
print('Less than int min:', outOfRangeLo);
var outOfRangeLoToInt = outOfRangeLo.int();
print('Less than int min cast to int becomes int min:', outOfRangeLoToInt);
إعداد Python
راجِع صفحة
بيئة Python للحصول على معلومات حول واجهة برمجة التطبيقات Python واستخدام
geemap
للتطوير التفاعلي.
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())
int_number = number.int()
print('Number cast to int:', int_number.getInfo())
"""Casting numbers to int 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 int loses decimal precision.
float_number = ee.Number(1.7)
print('Floating point value:', float_number.getInfo())
float_to_int = float_number.int()
print('Floating point value cast to int:', float_to_int.getInfo())
# A number greater than int range max cast to int becomes int range max.
INT_MAX = 2147483647
out_of_range_hi = ee.Number(INT_MAX + 12345)
print('Greater than int max:', out_of_range_hi.getInfo())
out_of_range_hi_to_int = out_of_range_hi.int()
print('Greater than int max cast to int becomes int max:',
out_of_range_hi_to_int.getInfo())
# A number greater than int range min cast to int becomes int range min.
INT_MIN = -2147483648
out_of_range_lo = ee.Number(INT_MIN - 12345)
print('Less than int min:', out_of_range_lo.getInfo())
out_of_range_lo_to_int = out_of_range_lo.int()
print('Less than int min cast to int becomes int min:',
out_of_range_lo_to_int.getInfo())
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe \u003ccode\u003eint()\u003c/code\u003e function casts a given input Number to a signed 32-bit integer within the range of [-2147483648, 2147483647].\u003c/p\u003e\n"],["\u003cp\u003eCasting floating-point numbers using \u003ccode\u003eint()\u003c/code\u003e will result in the loss of decimal precision, truncating the decimal portion.\u003c/p\u003e\n"],["\u003cp\u003eIf the input number exceeds the maximum value for a signed 32-bit integer, the result will be capped at the maximum value (2147483647).\u003c/p\u003e\n"],["\u003cp\u003eConversely, if the input number is less than the minimum value for a signed 32-bit integer, the result will be set to the minimum value (-2147483648).\u003c/p\u003e\n"]]],[],null,["# ee.Number.int\n\nCasts the input value to a signed 32-bit integer.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|----------------|---------|\n| Number.int`()` | 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 intNumber = number.int();\nprint('Number cast to int:', intNumber);\n\n\n/**\n * Casting numbers to int 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 int loses decimal precision.\nvar float = ee.Number(1.7);\nprint('Floating point value:', float);\n\nvar floatToInt = float.int();\nprint('Floating point value cast to int:', floatToInt);\n\n// A number greater than int range max cast to int becomes int range max.\nvar INT_MAX = 2147483647;\nvar outOfRangeHi = ee.Number(INT_MAX + 12345);\nprint('Greater than int max:', outOfRangeHi);\n\nvar outOfRangeHiToInt = outOfRangeHi.int();\nprint('Greater than int max cast to int becomes int max:', outOfRangeHiToInt);\n\n// A number greater than int range min cast to int becomes int range min.\nvar INT_MIN = -2147483648;\nvar outOfRangeLo = ee.Number(INT_MIN - 12345);\nprint('Less than int min:', outOfRangeLo);\n\nvar outOfRangeLoToInt = outOfRangeLo.int();\nprint('Less than int min cast to int becomes int min:', outOfRangeLoToInt);\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\nint_number = number.int()\nprint('Number cast to int:', int_number.getInfo())\n\n\n\"\"\"Casting numbers to int 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 int loses decimal precision.\nfloat_number = ee.Number(1.7)\nprint('Floating point value:', float_number.getInfo())\n\nfloat_to_int = float_number.int()\nprint('Floating point value cast to int:', float_to_int.getInfo())\n\n# A number greater than int range max cast to int becomes int range max.\nINT_MAX = 2147483647\nout_of_range_hi = ee.Number(INT_MAX + 12345)\nprint('Greater than int max:', out_of_range_hi.getInfo())\n\nout_of_range_hi_to_int = out_of_range_hi.int()\nprint('Greater than int max cast to int becomes int max:',\n out_of_range_hi_to_int.getInfo())\n\n# A number greater than int range min cast to int becomes int range min.\nINT_MIN = -2147483648\nout_of_range_lo = ee.Number(INT_MIN - 12345)\nprint('Less than int min:', out_of_range_lo.getInfo())\n\nout_of_range_lo_to_int = out_of_range_lo.int()\nprint('Less than int min cast to int becomes int min:',\n out_of_range_lo_to_int.getInfo())\n```"]]