ee.Number.toInt16

  • Number.toInt16() casts a number to a signed 16-bit integer, ranging from -32768 to 32767.

  • Casting a floating-point number to int16 results in the loss of decimal precision.

  • Numbers exceeding the int16 maximum or minimum range when cast to int16 will be truncated to the respective maximum or minimum value of the int16 range.

Casts the input value to a signed 16-bit integer.
Usage Returns
Number. toInt16 () Number
Argument Type Details
this: input
Number The input value.

Examples

Code Editor (JavaScript)

 // Cast a number to signed 16-bit integer: [-32768, 32767]. 
 var 
  
 number 
  
 = 
  
 ee 
 . 
 Number 
 ( 
 100 
 ); 
 print 
 ( 
 'Number:' 
 , 
  
 number 
 ); 
 var 
  
 int16Number 
  
 = 
  
 number 
 . 
 toInt16 
 (); 
 print 
 ( 
 'Number cast to int16:' 
 , 
  
 int16Number 
 ); 
 /** 
 * Casting numbers to int16 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 int16 loses decimal precision. 
 var 
  
 float 
  
 = 
  
 ee 
 . 
 Number 
 ( 
 1.7 
 ); 
 print 
 ( 
 'Floating point value:' 
 , 
  
 float 
 ); 
 var 
  
 floatToInt16 
  
 = 
  
 float 
 . 
 toInt16 
 (); 
 print 
 ( 
 'Floating point value cast to int16:' 
 , 
  
 floatToInt16 
 ); 
 // A number greater than int16 range max cast to int16 becomes int16 range max. 
 var 
  
 INT16_MAX 
  
 = 
  
 32767 
 ; 
 var 
  
 outOfRangeHi 
  
 = 
  
 ee 
 . 
 Number 
 ( 
 INT16_MAX 
  
 + 
  
 12345 
 ); 
 print 
 ( 
 'Greater than int16 max:' 
 , 
  
 outOfRangeHi 
 ); 
 var 
  
 outOfRangeHiToInt16 
  
 = 
  
 outOfRangeHi 
 . 
 toInt16 
 (); 
 print 
 ( 
 'Greater than int16 max cast to int16 becomes int16 max:' 
 , 
  
 outOfRangeHiToInt16 
 ); 
 // A number greater than int16 range min cast to int16 becomes int16 range min. 
 var 
  
 INT16_MIN 
  
 = 
  
 - 
 32768 
 ; 
 var 
  
 outOfRangeLo 
  
 = 
  
 ee 
 . 
 Number 
 ( 
 INT16_MIN 
  
 - 
  
 12345 
 ); 
 print 
 ( 
 'Less than int16 min:' 
 , 
  
 outOfRangeLo 
 ); 
 var 
  
 outOfRangeLoToInt16 
  
 = 
  
 outOfRangeLo 
 . 
 toInt16 
 (); 
 print 
 ( 
 'Less than int16 min cast to int16 becomes int16 min:' 
 , 
  
 outOfRangeLoToInt16 
 ); 

Python setup

See the Python Environment page for information on the Python API and using geemap for interactive development.

 import 
  
 ee 
 import 
  
 geemap.core 
  
 as 
  
 geemap 

Colab (Python)

 # Cast a number to signed 16-bit integer: [-32768, 32767]. 
 number 
 = 
 ee 
 . 
 Number 
 ( 
 100 
 ) 
 display 
 ( 
 'Number:' 
 , 
 number 
 ) 
 int16_number 
 = 
 number 
 . 
 toInt16 
 () 
 display 
 ( 
 'Number cast to int16:' 
 , 
 int16_number 
 ) 
 """Casting numbers to int16 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 int16 loses decimal precision. 
 float_number 
 = 
 ee 
 . 
 Number 
 ( 
 1.7 
 ) 
 display 
 ( 
 'Floating point value:' 
 , 
 float_number 
 ) 
 float_to_int16 
 = 
 float_number 
 . 
 toInt16 
 () 
 display 
 ( 
 'Floating point value cast to int16:' 
 , 
 float_to_int16 
 ) 
 # A number greater than int16 range max cast to int16 becomes int16 range max. 
 INT16_MAX 
 = 
 32767 
 out_of_range_hi 
 = 
 ee 
 . 
 Number 
 ( 
 INT16_MAX 
 + 
 12345 
 ) 
 display 
 ( 
 'Greater than int16 max:' 
 , 
 out_of_range_hi 
 ) 
 out_of_range_hi_to_int16 
 = 
 out_of_range_hi 
 . 
 toInt16 
 () 
 display 
 ( 
 'Greater than int16 max cast to int16 becomes int16 max:' 
 , 
 out_of_range_hi_to_int16 
 ) 
 # A number greater than int16 range min cast to int16 becomes int16 range min. 
 INT16_MIN 
 = 
 - 
 32768 
 out_of_range_lo 
 = 
 ee 
 . 
 Number 
 ( 
 INT16_MIN 
 - 
 12345 
 ) 
 display 
 ( 
 'Less than int16 min:' 
 , 
 out_of_range_lo 
 ) 
 out_of_range_lo_to_int16 
 = 
 out_of_range_lo 
 . 
 toInt16 
 () 
 display 
 ( 
 'Less than int16 min cast to int16 becomes int16 min:' 
 , 
 out_of_range_lo_to_int16 
 ) 
Create a Mobile Website
View Site in Mobile | Classic
Share by: