Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.Number.long
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.long() | 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.long();
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.long();
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.long()
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.long()
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\u003e\u003ccode\u003enumber.long()\u003c/code\u003e casts the input Number value to a signed 64-bit integer.\u003c/p\u003e\n"],["\u003cp\u003eCasting floating point numbers to long using this method results in the loss of decimal precision.\u003c/p\u003e\n"],["\u003cp\u003eThe method returns an \u003ccode\u003eee.Number\u003c/code\u003e object representing the integer value.\u003c/p\u003e\n"]]],["The `Number.long()` method casts an input value to a signed 64-bit integer. It takes a Number as input and returns a Number. Casting a floating-point number to long results in the loss of decimal precision. Numbers outside the range and precision of a 64-bit integer may be modified during the cast. Examples demonstrate casting a regular number and a floating number into long using JavaScript and Python.\n"],null,["# ee.Number.long\n\nCasts the input value to a signed 64-bit integer.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-----------------|---------|\n| Number.long`()` | 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.long();\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.long();\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.long()\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.long()\nprint('Floating point value cast to long:', float_to_long.getInfo())\n```"]]