公告 :凡是在
2025 年 4 月 15 日前 註冊使用 Earth Engine 的非商業專案,都必須
驗證非商業用途資格 ,才能繼續存取。如未在 2025 年 9 月 26 日前完成驗證,存取權可能會暫停。
提供意見
ee.Number.toShort
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
將輸入值轉換為帶正負號的 16 位元整數。
範例
程式碼編輯器 (JavaScript)
// Cast a number to signed 16-bit integer: [-32768, 32767].
var number = ee . Number ( 100 );
print ( 'Number:' , number );
var shortNumber = number . toShort ();
print ( 'Number cast to short:' , shortNumber );
/**
* Casting numbers to short 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 short loses decimal precision.
var float = ee . Number ( 1.7 );
print ( 'Floating point value:' , float );
var floatToShort = float . toShort ();
print ( 'Floating point value cast to short:' , floatToShort );
// A number greater than short range max cast to short becomes short range max.
var SHORT_MAX = 32767 ;
var outOfRangeHi = ee . Number ( SHORT_MAX + 12345 );
print ( 'Greater than short max:' , outOfRangeHi );
var outOfRangeHiToShort = outOfRangeHi . toShort ();
print ( 'Greater than short max cast to short becomes short max:' , outOfRangeHiToShort );
// A number greater than short range min cast to short becomes short range min.
var SHORT_MIN = - 32768 ;
var outOfRangeLo = ee . Number ( SHORT_MIN - 12345 );
print ( 'Less than short min:' , outOfRangeLo );
var outOfRangeLoToShort = outOfRangeLo . toShort ();
print ( 'Less than short min cast to short becomes short min:' , outOfRangeLoToShort );
Python 設定
請參閱
Python 環境 頁面,瞭解 Python API 和如何使用 geemap
進行互動式開發。
import ee
import geemap.core as geemap
Colab (Python)
# Cast a number to signed 16-bit integer: [-32768, 32767].
number = ee . Number ( 100 )
print ( 'Number:' , number . getInfo ())
short_number = number . toShort ()
print ( 'Number cast to short:' , short_number . getInfo ())
"""Casting numbers to short 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 short loses decimal precision.
float_number = ee . Number ( 1.7 )
print ( 'Floating point value:' , float_number . getInfo ())
float_to_short = float_number . toShort ()
print ( 'Floating point value cast to short:' , float_to_short . getInfo ())
# A number greater than short range max cast to short becomes short range max.
SHORT_MAX = 32767
out_of_range_hi = ee . Number ( SHORT_MAX + 12345 )
print ( 'Greater than short max:' , out_of_range_hi . getInfo ())
out_of_range_hi_to_short = out_of_range_hi . toShort ()
print ( 'Greater than short max cast to short becomes short max:' ,
out_of_range_hi_to_short . getInfo ())
# A number greater than short range min cast to short becomes short range min.
SHORT_MIN = - 32768
out_of_range_lo = ee . Number ( SHORT_MIN - 12345 )
print ( 'Less than short min:' , out_of_range_lo . getInfo ())
out_of_range_lo_to_short = out_of_range_lo . toShort ()
print ( 'Less than short min cast to short becomes short min:' ,
out_of_range_lo_to_short . getInfo ())
提供意見
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權 ,程式碼範例則為阿帕契 2.0 授權 。詳情請參閱《Google Developers 網站政策 》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-26 (世界標準時間)。
想進一步說明嗎?
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-07-26 (世界標準時間)。"],[],["The `toShort()` method casts a number to a signed 16-bit integer, ranging from -32768 to 32767. Floating-point numbers lose decimal precision when cast. Values exceeding the maximum (32767) are converted to 32767, and values below the minimum (-32768) become -32768. The method takes a number as input and returns a signed 16-bit integer.\n"]]