ee.Number.long

  • The long() method casts an input number to a signed 64-bit integer.

  • Using long() on a floating-point number will result in the loss of decimal precision.

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

UsageReturns
Number.long()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.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)
display('ee.Number:', number)

# Cast a number to signed 64-bit integer.
long_number = number.long()
display('ee.Number cast to long:', long_number)


"""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)
display('Floating point value:', float_number)

float_to_long = float_number.long()
display('Floating point value cast to long:', float_to_long)