공지사항 :
2025년 4월 15일 전에 Earth Engine 사용을 위해 등록된 모든 비상업용 프로젝트는 액세스 권한을 유지하기 위해
비상업용 자격 요건을 인증 해야 합니다. 2025년 9월 26일까지 인증하지 않으면 액세스가 보류될 수 있습니다.
의견 보내기
ee.Number.toInt32
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
입력 값을 부호 있는 32비트 정수로 변환합니다.
인수 유형 세부정보 다음과 같은 경우: input
숫자 입력 값입니다.
예
코드 편집기 (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 ())
의견 보내기
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스 에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스 에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책 을 참조하세요. 자바는 Oracle 및/또는 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"]]