お知らせ :
2025 年 4 月 15 日 より前に Earth Engine の使用を登録したすべての非商用プロジェクトは、アクセスを維持するために
非商用目的での利用資格を確認 する必要があります。2025 年 9 月 26 日までに確認が完了していない場合、アクセスが保留されることがあります。
フィードバックを送信
ee.Number.toInt32
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
入力値を符号付き 32 ビット整数にキャストします。
例
コードエディタ(JavaScript)
// Cast a number to signed 32-bit integer: [-2147483648, 2147483647].
var number = ee . Number ( 100 );
print ( 'Number:' , number );
var int32Number = number . toInt32 ();
print ( 'Number cast to int32:' , int32Number );
/**
* Casting numbers to int32 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 int32 loses decimal precision.
var float = ee . Number ( 1.7 );
print ( 'Floating point value:' , float );
var floatToInt32 = float . toInt32 ();
print ( 'Floating point value cast to int32:' , floatToInt32 );
// A number greater than int32 range max cast to int32 becomes int32 range max.
var INT32_MAX = 2147483647 ;
var outOfRangeHi = ee . Number ( INT32_MAX + 12345 );
print ( 'Greater than int32 max:' , outOfRangeHi );
var outOfRangeHiToInt32 = outOfRangeHi . toInt32 ();
print ( 'Greater than int32 max cast to int32 becomes int32 max:' , outOfRangeHiToInt32 );
// A number greater than int32 range min cast to int32 becomes int32 range min.
var INT32_MIN = - 2147483648 ;
var outOfRangeLo = ee . Number ( INT32_MIN - 12345 );
print ( 'Less than int32 min:' , outOfRangeLo );
var outOfRangeLoToInt32 = outOfRangeLo . toInt32 ();
print ( 'Less than int32 min cast to int32 becomes int32 min:' , outOfRangeLoToInt32 );
Python の設定
Python API とインタラクティブな開発での geemap
の使用については、
Python 環境 のページをご覧ください。
import ee
import geemap.core as geemap
Colab(Python)
# Cast a number to signed 32-bit integer: [-2147483648, 2147483647].
number = ee . Number ( 100 )
print ( 'Number:' , number . getInfo ())
int32_number = number . toInt32 ()
print ( 'Number cast to int32:' , int32_number . getInfo ())
"""Casting numbers to int32 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 int32 loses decimal precision.
float_number = ee . Number ( 1.7 )
print ( 'Floating point value:' , float_number . getInfo ())
float_to_int32 = float_number . toInt32 ()
print ( 'Floating point value cast to int32:' , float_to_int32 . getInfo ())
# A number greater than int32 range max cast to int32 becomes int32 range max.
INT32_MAX = 2147483647
out_of_range_hi = ee . Number ( INT32_MAX + 12345 )
print ( 'Greater than int32 max:' , out_of_range_hi . getInfo ())
out_of_range_hi_to_int32 = out_of_range_hi . toInt32 ()
print ( 'Greater than int32 max cast to int32 becomes int32 max:' ,
out_of_range_hi_to_int32 . getInfo ())
# A number greater than int32 range min cast to int32 becomes int32 range min.
INT32_MIN = - 2147483648
out_of_range_lo = ee . Number ( INT32_MIN - 12345 )
print ( 'Less than int32 min:' , out_of_range_lo . getInfo ())
out_of_range_lo_to_int32 = out_of_range_lo . toInt32 ()
print ( 'Less than int32 min cast to int32 becomes int32 min:' ,
out_of_range_lo_to_int32 . getInfo ())
フィードバックを送信
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンス により使用許諾されます。コードサンプルは Apache 2.0 ライセンス により使用許諾されます。詳しくは、Google Developers サイトのポリシー をご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-26 UTC。
ご意見をお聞かせください
[[["わかりやすい","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 UTC。"],[],["The `toInt32()` method casts a number to a signed 32-bit integer, with a range from -2147483648 to 2147483647. Floating-point numbers lose decimal precision when cast. Numbers exceeding the maximum range become the maximum value, while numbers below the minimum range become the minimum value. It accepts an `input` value of type `Number` and returns a `Number` representing the signed 32-bit integer.\n"]]