Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.Number.toLong
Stay organized with collections
Save and categorize content based on your preferences.
Casts the input value to a signed 64-bit integer.
| Usage | Returns | Number.toLong() | Number |
| Argument | Type | Details | this: input | Number | The input value. |
Examples
Code Editor (JavaScript)
// Declare an ee.Number.
var number = ee.Number(100);
print('ee.Number:', number);
// Cast a number to signed 64-bit integer.
var longNumber = number.toLong();
print('ee.Number cast to long:', longNumber);
/**
* Casting numbers to long 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 long loses decimal precision.
var float = ee.Number(1.7);
print('Floating point value:', float);
var floatToLong = float.toLong();
print('Floating point value cast to long:', floatToLong);
Python setup
See the
Python Environment page for information on the Python API and using
geemap for interactive development.
import ee
import geemap.core as geemap
Colab (Python)
# Declare an ee.Number.
number = ee.Number(100)
print('ee.Number:', number.getInfo())
# Cast a number to signed 64-bit integer.
long_number = number.toLong()
print('ee.Number cast to long:', long_number.getInfo())
"""Casting numbers to long 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 long loses decimal precision.
float_number = ee.Number(1.7)
print('Floating point value:', float_number.getInfo())
float_to_long = float_number.toLong()
print('Floating point value cast to long:', float_to_long.getInfo())
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2023-10-06 UTC.
[null,null,["Last updated 2023-10-06 UTC."],[[["\u003cp\u003eThe \u003ccode\u003etoLong()\u003c/code\u003e function casts a given Earth Engine \u003ccode\u003eNumber\u003c/code\u003e to a signed 64-bit integer.\u003c/p\u003e\n"],["\u003cp\u003eCasting floating point numbers using \u003ccode\u003etoLong()\u003c/code\u003e will result in loss of decimal precision, effectively truncating the decimal portion.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003etoLong()\u003c/code\u003e can be accessed on any Earth Engine \u003ccode\u003eNumber\u003c/code\u003e object using \u003ccode\u003enumber.toLong()\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# ee.Number.toLong\n\nCasts the input value to a signed 64-bit integer.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-------------------|---------|\n| Number.toLong`()` | 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// Declare an ee.Number.\nvar number = ee.Number(100);\nprint('ee.Number:', number);\n\n// Cast a number to signed 64-bit integer.\nvar longNumber = number.toLong();\nprint('ee.Number cast to long:', longNumber);\n\n\n/**\n* Casting numbers to long 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 long loses decimal precision.\nvar float = ee.Number(1.7);\nprint('Floating point value:', float);\n\nvar floatToLong = float.toLong();\nprint('Floating point value cast to long:', floatToLong);\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# Declare an ee.Number.\nnumber = ee.Number(100)\nprint('ee.Number:', number.getInfo())\n\n# Cast a number to signed 64-bit integer.\nlong_number = number.toLong()\nprint('ee.Number cast to long:', long_number.getInfo())\n\n\n\"\"\"Casting numbers to long 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 long loses decimal precision.\nfloat_number = ee.Number(1.7)\nprint('Floating point value:', float_number.getInfo())\n\nfloat_to_long = float_number.toLong()\nprint('Floating point value cast to long:', float_to_long.getInfo())\n```"]]