Announcement: All noncommercial projects registered to use Earth Engine beforeApril 15, 2025 mustverify noncommercial eligibility to maintain access. If you have not verified by September 26, 2025, your access may be on hold.

ee.Number.firstNonZero

  • ThefirstNonZero method selects the first value if it is non-zero and the second value otherwise.

  • This method takes two Number inputs, a left-hand value (this) and a right-hand value (right).

  • The output offirstNonZero is a single Number.

 Selects the first value if it is non-zero, and the second value otherwise.

UsageReturns
Number.firstNonZero(right)Number
ArgumentTypeDetails
this:leftNumberThe left-hand value.
rightNumberThe right-hand value.

Examples

Code Editor (JavaScript)

print('First non-zero: 0, 5',ee.Number(0).firstNonZero(ee.Number(5)));// 5print('First non-zero: 5, 0',ee.Number(5).firstNonZero(ee.Number(0)));// 5

Python setup

See the Python Environment page for information on the Python API and usinggeemap for interactive development.

importeeimportgeemap.coreasgeemap

Colab (Python)

display('First non-zero in [0, 5]:',ee.Number(0).firstNonZero(ee.Number(5)))# 5display('First non-zero in [5, 0]:',ee.Number(5).firstNonZero(ee.Number(0)))# 5

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2023-10-06 UTC.