ee.Number.parse

  • ee.Number.parse() converts a string to an Earth Engine Number object.

  • The function accepts an optional radix argument for specifying the base of the number system (default is 10).

  • Leading zeros in the input string are automatically removed during conversion.

  • The function can handle various input types like client-side strings, Earth Engine Strings, and values retrieved from Earth Engine features.

 Convert a string to a number.

UsageReturns
ee.Number.parse(input, radix)Number
ArgumentTypeDetails
inputStringThe string to convert to a number.
radixInteger, default: 10An integer representing the base number system from which to convert. If input is not an integer, radix must equal 10 or not be specified.

Examples

Code Editor (JavaScript)

print('Client-side string converted to ee.Number',
      ee.Number.parse('10'));  // 10

print('ee.String converted to ee.Number',
      ee.Number.parse(ee.String('100')));  // 100

print('Ambiguous string object converted to ee.Number',
      ee.Number.parse(ee.Feature(null, {id: '1000'}).get('id')));  // 1000

print('Ambiguous number object converted to ee.Number',
      ee.Number.parse(ee.Feature(null, {id: 1000}).get('id')));  // 1000

print('Leading zeros are removed',
      ee.Number.parse('0001'));  // 1

print('Radix 16',
      ee.Number.parse('3E8', 16)); // 1000

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)

print('Client-side string converted to ee.Number:',
      ee.Number.parse('10').getInfo())  # 10

print('ee.String converted to ee.Number:',
      ee.Number.parse(ee.String('100')).getInfo())  # 100

# 1000
print('Ambiguous string object converted to ee.Number:',
      ee.Number.parse(ee.Feature(None, {'id': '1000'}).get('id')).getInfo())

print('Leading zeros are removed:',
      ee.Number.parse('0001').getInfo())  # 1

print('Radix 16:', ee.Number.parse('3E8', 16).getInfo()) # 1000