Объявление : Все некоммерческие проекты, зарегистрированные для использования Earth Engine до
15 апреля 2025 года, должны
подтвердить право на некоммерческое использование для сохранения доступа. Если вы не подтвердите право до 26 сентября 2025 года, ваш доступ может быть приостановлен.
ee.Number.toUint16
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Преобразует входное значение в беззнаковое 16-битное целое число.
| Использование | Возврат | Number. toUint16 () | Число |
| Аргумент | Тип | Подробности | это: input | Число | Входное значение. |
Примеры
Редактор кода (JavaScript)
// Cast a number to unsigned 16-bit integer: [0, 65535].
var number = ee.Number(100);
print('Number:', number);
var uint16Number = number.toUint16();
print('Number cast to uint16:', uint16Number);
/**
* Casting numbers to uint16 that are outside of its range and precision can
* modify the resulting value, note the behavior of the following scenarios.
*/
// A floating point number cast to uint16 loses decimal precision.
var float = ee.Number(1.7);
print('Floating point value:', float);
var floatToUint16 = float.toUint16();
print('Floating point value cast to uint16:', floatToUint16);
// A number greater than uint16 range max cast to uint16 becomes uint16 range max.
var UINT16_MAX = 65535;
var outOfRangeHi = ee.Number(UINT16_MAX + 12345);
print('Greater than uint16 max:', outOfRangeHi);
var outOfRangeHiToUint16 = outOfRangeHi.toUint16();
print('Greater than uint16 max cast to uint16 becomes uint16 max:', outOfRangeHiToUint16);
// A number greater than uint16 range min cast to uint16 becomes uint16 range min.
var UINT16_MIN = 0;
var outOfRangeLo = ee.Number(UINT16_MIN - 12345);
print('Less than uint16 min:', outOfRangeLo);
var outOfRangeLoToUint16 = outOfRangeLo.toUint16();
print('Less than uint16 min cast to uint16 becomes uint16 min:', outOfRangeLoToUint16); Настройка Python
Информацию об API Python и использовании geemap для интерактивной разработки см. на странице «Среда Python» .
import ee
import geemap.core as geemap
Colab (Python)
# Cast a number to unsigned 16-bit integer: [0, 65535].
number = ee.Number(100)
print('Number:', number.getInfo())
uint16_number = number.toUint16()
print('Number cast to uint16:', uint16_number.getInfo())
"""Casting numbers to uint16 that are outside of its range and precision can
modify the resulting value, note the behavior of the following scenarios.
"""
# A floating point number cast to uint16 loses decimal precision.
float_number = ee.Number(1.7)
print('Floating point value:', float_number.getInfo())
float_to_uint16 = float_number.toUint16()
print('Floating point value cast to uint16:', float_to_uint16.getInfo())
# A number greater than uint16 range max cast to uint16
# becomes uint16 range max.
UINT16_MAX = 65535
out_of_range_hi = ee.Number(UINT16_MAX + 12345)
print('Greater than uint16 max:', out_of_range_hi.getInfo())
out_of_range_hi_to_uint16 = out_of_range_hi.toUint16()
print('Greater than uint16 max cast to uint16 becomes uint16 max:',
out_of_range_hi_to_uint16.getInfo())
# A number greater than uint16 range min cast to uint16
# becomes uint16 range min.
UINT16_MIN = 0
out_of_range_lo = ee.Number(UINT16_MIN - 12345)
print('Less than uint16 min:', out_of_range_lo.getInfo())
out_of_range_lo_to_uint16 = out_of_range_lo.toUint16()
print('Less than uint16 min cast to uint16 becomes uint16 min:',
out_of_range_lo_to_uint16.getInfo())
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-24 UTC.
[null,null,["Последнее обновление: 2025-07-24 UTC."],[],["The `toUint16()` method casts a number to an unsigned 16-bit integer, with a valid range of 0 to 65535. Input values outside this range are adjusted: values exceeding 65535 become 65535, and those below 0 become 0. Floating-point numbers lose their decimal precision. The method accepts the input number as an argument and returns the cast `Number`. Example code in Javascript and Python, show the casting and boundary behaviors.\n"]]