ee.Number.long

  • number.long() casts the input Number value to a signed 64-bit integer.

  • Casting floating point numbers to long using this method results in the loss of decimal precision.

  • The method returns an ee.Number object representing the integer value.

 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)
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())