公告：所有在
2025 年 4 月 15 日之前注册使用 Earth Engine 的非商业项目都必须
验证是否符合非商业性质的资格条件，才能继续使用 Earth Engine。
ee.Number.clamp
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
将值限制在最小值到最大值范围内。
| 用法 | 返回 |
|---|
Number.clamp(min, max) | 数字 |
| 参数 | 类型 | 详细信息 |
|---|
此：number | 数字 | |
min | 浮点数 | 要钳制的最小值。 |
max | 浮点数 | 要钳制到的最大值。 |
示例
代码编辑器 (JavaScript)
// Numbers within range are unaffected.
print('100 clamped to range [0,255]', ee.Number(100).clamp(0, 255)); // 100
// Numbers greater than max in range are set to max.
print('259 clamped to range [0,255]', ee.Number(259).clamp(0, 255)); // 255
// Numbers less than min in range are set to min.
print('-259 clamped to range [0,255]', ee.Number(-259).clamp(0, 255)); // 0
Python 设置
如需了解 Python API 和如何使用 geemap 进行交互式开发，请参阅
Python 环境页面。
import ee
import geemap.core as geemap
Colab (Python)
# Numbers within range are unaffected.
# 100
print('100 clamped to range [0,255]:', ee.Number(100).clamp(0, 255).getInfo())
# Numbers greater than max in range are set to max.
# 255
print('259 clamped to range [0,255]:', ee.Number(259).clamp(0, 255).getInfo())
# Numbers less than min in range are set to min.
# 0
print('-259 clamped to range [0,255]:', ee.Number(-259).clamp(0, 255).getInfo())
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-07-26。
[null,null,["最后更新时间 (UTC)：2025-07-26。"],[[["\u003cp\u003e\u003ccode\u003eNumber.clamp()\u003c/code\u003e constrains a number to a specified range, returning the original number if it falls within the range.\u003c/p\u003e\n"],["\u003cp\u003eIf the number exceeds the maximum value of the range, the function returns the maximum value instead.\u003c/p\u003e\n"],["\u003cp\u003eIf the number is less than the minimum value of the range, the function returns the minimum value.\u003c/p\u003e\n"],["\u003cp\u003eThis function is useful for ensuring that numeric values stay within desired bounds.\u003c/p\u003e\n"]]],["The `clamp(min, max)` function restricts a number within a specified range. It accepts a number, a minimum (`min`), and a maximum (`max`) value as arguments. If the number falls within the `min` and `max` range, it remains unchanged. Numbers exceeding `max` are set to `max`, and those below `min` are set to `min`. The function returns a number. Example, `100` within the range of `0,255` will stay as `100`, while `259` becomes `255` and `-259` becomes `0` in the same range.\n"],null,["# ee.Number.clamp\n\nClamps the value to lie within the range of min to max.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|--------------------------|---------|\n| Number.clamp`(min, max)` | Number |\n\n| Argument | Type | Details |\n|----------------|--------|--------------------------------|\n| this: `number` | Number | |\n| `min` | Float | The minimum value to clamp to. |\n| `max` | Float | The maximum value to clamp to. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// Numbers within range are unaffected.\nprint('100 clamped to range [0,255]', ee.Number(100).clamp(0, 255)); // 100\n\n// Numbers greater than max in range are set to max.\nprint('259 clamped to range [0,255]', ee.Number(259).clamp(0, 255)); // 255\n\n// Numbers less than min in range are set to min.\nprint('-259 clamped to range [0,255]', ee.Number(-259).clamp(0, 255)); // 0\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\n# Numbers within range are unaffected.\n# 100\nprint('100 clamped to range [0,255]:', ee.Number(100).clamp(0, 255).getInfo())\n\n# Numbers greater than max in range are set to max.\n# 255\nprint('259 clamped to range [0,255]:', ee.Number(259).clamp(0, 255).getInfo())\n\n# Numbers less than min in range are set to min.\n# 0\nprint('-259 clamped to range [0,255]:', ee.Number(-259).clamp(0, 255).getInfo())\n```"]]
