Announcement: All noncommercial projects registered to use Earth Engine before April 15, 2025 must verify noncommercial eligibility to maintain Earth Engine access.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["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```"]]