ee.Number.toInt64
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
مقدار ورودی را به یک عدد صحیح 64 بیتی امضا شده ارسال می کند.
استفاده | برمی گرداند | Number. toInt64 () | شماره |
استدلال | تایپ کنید | جزئیات | این: input | شماره | مقدار ورودی |
نمونه ها
ویرایشگر کد (جاوا اسکریپت)
// Cast a number to signed 64-bit integer: [-9223372036854776000, 9223372036854776000].
var number = ee.Number(100);
print('Number:', number);
var int64Number = number.toInt64();
print('Number cast to int64:', int64Number);
/**
* Casting numbers to int64 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 int64 loses decimal precision.
var float = ee.Number(1.7);
print('Floating point value:', float);
var floatToInt64 = float.toInt64();
print('Floating point value cast to int64:', floatToInt64);
// A number greater than int64 range max cast to int64 becomes int64 range max.
var INT64_MAX = 9223372036854776000;
var outOfRangeHi = ee.Number(INT64_MAX + 12345);
print('Greater than int64 max:', outOfRangeHi);
var outOfRangeHiToInt64 = outOfRangeHi.toInt64();
print('Greater than int64 max cast to int64 becomes int64 max:', outOfRangeHiToInt64);
// A number greater than int64 range min cast to int64 becomes int64 range min.
var INT64_MIN = -9223372036854776000;
var outOfRangeLo = ee.Number(INT64_MIN - 12345);
print('Less than int64 min:', outOfRangeLo);
var outOfRangeLoToInt64 = outOfRangeLo.toInt64();
print('Less than int64 min cast to int64 becomes int64 min:', outOfRangeLoToInt64);
راه اندازی پایتون
برای اطلاعات در مورد API پایتون و استفاده از geemap
برای توسعه تعاملی به صفحه محیط پایتون مراجعه کنید.
import ee
import geemap.core as geemap
کولب (پایتون)
# Cast a number to signed 64-bit integer:
# [-9223372036854775808, 9223372036854775808].
number = ee.Number(100)
print('Number:', number.getInfo())
int64_number = number.toInt64()
print('Number cast to int64:', int64_number.getInfo())
"""Casting numbers to int64 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 int64 loses decimal precision.
float_number = ee.Number(1.7)
print('Floating point value:', float_number.getInfo())
float_to_int64 = float_number.toInt64()
print('Floating point value cast to int64:', float_to_int64.getInfo())
# A number greater than int64 range max becomes int64 range max.
# Python int is too large to be mapped to int64, use float instead.
INT64_MAX = 9223372036854775808.0
out_of_range_hi = ee.Number(INT64_MAX + 12345)
print('Greater than int64 max:', '{:.0f}'.format(out_of_range_hi.getInfo()))
out_of_range_hi_to_int64 = out_of_range_hi.toInt64()
print('Greater than int64 max cast to int64 becomes int64 max:',
'{:.0f}'.format(out_of_range_hi_to_int64.getInfo()))
# A number greater than int64 range min becomes int64 range min.
# Python int is too large to be mapped to int64, use float instead.
INT64_MIN = -9223372036854775808.0
out_of_range_lo = ee.Number(INT64_MIN - 12345)
print('Less than int64 min:', '{:.0f}'.format(out_of_range_lo.getInfo()))
out_of_range_lo_to_int64 = out_of_range_lo.toInt64()
print('Less than int64 min cast to int64 becomes int64 min:',
'{:.0f}'.format(out_of_range_lo_to_int64.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.toInt64()\u003c/code\u003e casts a given Earth Engine \u003ccode\u003eNumber\u003c/code\u003e value to a signed 64-bit integer.\u003c/p\u003e\n"],["\u003cp\u003eCasting floating point numbers using this function will result in a loss of decimal precision.\u003c/p\u003e\n"],["\u003cp\u003eInput values exceeding the maximum or minimum bounds of a signed 64-bit integer will be coerced to the respective boundary value upon conversion.\u003c/p\u003e\n"]]],[],null,["# ee.Number.toInt64\n\nCasts the input value to a signed 64-bit integer.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|--------------------|---------|\n| Number.toInt64`()` | 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 64-bit integer: [-9223372036854776000, 9223372036854776000].\nvar number = ee.Number(100);\nprint('Number:', number);\n\nvar int64Number = number.toInt64();\nprint('Number cast to int64:', int64Number);\n\n\n/**\n * Casting numbers to int64 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 int64 loses decimal precision.\nvar float = ee.Number(1.7);\nprint('Floating point value:', float);\n\nvar floatToInt64 = float.toInt64();\nprint('Floating point value cast to int64:', floatToInt64);\n\n// A number greater than int64 range max cast to int64 becomes int64 range max.\nvar INT64_MAX = 9223372036854776000;\nvar outOfRangeHi = ee.Number(INT64_MAX + 12345);\nprint('Greater than int64 max:', outOfRangeHi);\n\nvar outOfRangeHiToInt64 = outOfRangeHi.toInt64();\nprint('Greater than int64 max cast to int64 becomes int64 max:', outOfRangeHiToInt64);\n\n// A number greater than int64 range min cast to int64 becomes int64 range min.\nvar INT64_MIN = -9223372036854776000;\nvar outOfRangeLo = ee.Number(INT64_MIN - 12345);\nprint('Less than int64 min:', outOfRangeLo);\n\nvar outOfRangeLoToInt64 = outOfRangeLo.toInt64();\nprint('Less than int64 min cast to int64 becomes int64 min:', outOfRangeLoToInt64);\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 64-bit integer:\n# [-9223372036854775808, 9223372036854775808].\nnumber = ee.Number(100)\nprint('Number:', number.getInfo())\n\nint64_number = number.toInt64()\nprint('Number cast to int64:', int64_number.getInfo())\n\n\n\"\"\"Casting numbers to int64 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 int64 loses decimal precision.\nfloat_number = ee.Number(1.7)\nprint('Floating point value:', float_number.getInfo())\n\nfloat_to_int64 = float_number.toInt64()\nprint('Floating point value cast to int64:', float_to_int64.getInfo())\n\n# A number greater than int64 range max becomes int64 range max.\n# Python int is too large to be mapped to int64, use float instead.\nINT64_MAX = 9223372036854775808.0\nout_of_range_hi = ee.Number(INT64_MAX + 12345)\nprint('Greater than int64 max:', '{:.0f}'.format(out_of_range_hi.getInfo()))\n\nout_of_range_hi_to_int64 = out_of_range_hi.toInt64()\nprint('Greater than int64 max cast to int64 becomes int64 max:',\n '{:.0f}'.format(out_of_range_hi_to_int64.getInfo()))\n\n# A number greater than int64 range min becomes int64 range min.\n# Python int is too large to be mapped to int64, use float instead.\nINT64_MIN = -9223372036854775808.0\nout_of_range_lo = ee.Number(INT64_MIN - 12345)\nprint('Less than int64 min:', '{:.0f}'.format(out_of_range_lo.getInfo()))\n\nout_of_range_lo_to_int64 = out_of_range_lo.toInt64()\nprint('Less than int64 min cast to int64 becomes int64 min:',\n '{:.0f}'.format(out_of_range_lo_to_int64.getInfo()))\n```"]]