Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.Number.firstNonZero
Stay organized with collections
Save and categorize content based on your preferences.
Selects the first value if it is non-zero, and the second value otherwise.
| Usage | Returns | Number.firstNonZero(right) | Number |
| Argument | Type | Details | this: left | Number | The left-hand value. |
right | Number | The right-hand value. |
Examples
Code Editor (JavaScript)
print('First non-zero: 0, 5', ee.Number(0).firstNonZero(ee.Number(5))); // 5
print('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 using
geemap for interactive development.
import ee
import geemap.core as geemap
Colab (Python)
print('First non-zero in [0, 5]:',
ee.Number(0).firstNonZero(ee.Number(5)).getInfo()) # 5
print('First non-zero in [5, 0]:',
ee.Number(5).firstNonZero(ee.Number(0)).getInfo()) # 5
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2023-10-06 UTC.
[null,null,["Last updated 2023-10-06 UTC."],[[["\u003cp\u003e\u003ccode\u003efirstNonZero()\u003c/code\u003e is a method that selects and returns the first number if it is not zero, otherwise, it returns the second number.\u003c/p\u003e\n"],["\u003cp\u003eIt takes two arguments: the left-hand value (\u003ccode\u003ethis: left\u003c/code\u003e) and the right-hand value (\u003ccode\u003eright\u003c/code\u003e), both of which should be of type Number.\u003c/p\u003e\n"],["\u003cp\u003eThis function can be useful for conditional selections where a fallback value is needed if the primary value is zero.\u003c/p\u003e\n"]]],["The `firstNonZero` method, applied to a number (`left`), takes another number (`right`) as an argument. It returns the `left` value if it's non-zero; otherwise, it returns the `right` value. The method is available in both JavaScript and Python, operating on numerical data. Examples show that `firstNonZero` selects 5 when given (0, 5) or (5, 0) as inputs.\n"],null,["# ee.Number.firstNonZero\n\nSelects the first value if it is non-zero, and the second value otherwise.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|------------------------------|---------|\n| Number.firstNonZero`(right)` | Number |\n\n| Argument | Type | Details |\n|--------------|--------|-----------------------|\n| this: `left` | Number | The left-hand value. |\n| `right` | Number | The right-hand value. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\nprint('First non-zero: 0, 5', ee.Number(0).firstNonZero(ee.Number(5))); // 5\nprint('First non-zero: 5, 0', ee.Number(5).firstNonZero(ee.Number(0))); // 5\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\n### Colab (Python)\n\n```python\nprint('First non-zero in [0, 5]:',\n ee.Number(0).firstNonZero(ee.Number(5)).getInfo()) # 5\nprint('First non-zero in [5, 0]:',\n ee.Number(5).firstNonZero(ee.Number(0)).getInfo()) # 5\n```"]]