ee.Number.toLong

  • The toLong() function casts a given Earth Engine Number to a signed 64-bit integer.

  • Casting floating point numbers using toLong() will result in loss of decimal precision, effectively truncating the decimal portion.

  • toLong() can be accessed on any Earth Engine Number object using number.toLong().

 Casts the input value to a signed 64-bit integer.

UsageReturns
Number.toLong()Number
ArgumentTypeDetails
this: inputNumberThe 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())