公告：所有在
2025 年 4 月 15 日之前注册使用 Earth Engine 的非商业项目都必须
验证是否符合非商业性质的资格条件，才能继续使用 Earth Engine。
ee.Number.firstNonZero
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
如果第一个值不为零，则选择第一个值，否则选择第二个值。
| 用法 | 返回 |
|---|
Number.firstNonZero(right) | 数字 |
| 参数 | 类型 | 详细信息 |
|---|
此：left | 数字 | 左侧值。 |
right | 数字 | 右侧值。 |
示例
代码编辑器 (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 设置
如需了解 Python API 和如何使用 geemap 进行交互式开发，请参阅
Python 环境页面。
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
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-07-26。
[null,null,["最后更新时间 (UTC)：2025-07-26。"],[[["\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```"]]
