JavaScript метод Number.parseInt()ECMAScript 2015

JavaScript Number

Определение и применение

JavaScript метод parseInt()ECMAScript 2015 принимает в качестве аргумента строковое значение и возвращает целое число, которое соответствует указанному основанию системы счисления.


Обращаю Ваше внимание, что метод Number.parseInt()ECMAScript 2015 идентичен одноименной глобальной функции parseInt().


Поддержка браузерами

МетодChrome
Chrome
Firefox
Firefox
Opera
Opera
Safari
Safari
Internet Explorer
IExplorer
Microsoft Edge
Edge
parseInt()ECMAScript 2015Да25.0ДаДаНетДа

JavaScript синтаксис:

// возвращает целое число, которое соответствует восьмеричной, десятичной или шестнадцатиричной системе счисления (определяется автоматически)
Number.parseInt( string );

// возвращает целое число, которое соответствует указанному основанию системы счисления
Number.parseInt( string, radix );

Версия JavaScript

ECMAScript 2015 (6th Edition, ECMA-262)

Значения параметров

ПараметрОписание
stringСтроковое значение, которое будет преобразовано к целому числу. Обязательное значение.
Если метод parseInt()ECMAScript 2015 обнаруживает символ, который не входит в указанную систему счисления, то он игнорирует его и все последующие символы, при этом возвращаемое целочисленное значение будет усечено до подобного символа. Допускается передавать методу значения, которые содержат начальные и конечные пробелы. Если первый символ не может быть преобразован в число, то возвращаемое значение будет NaN. Кроме того, если в качестве значения будет передано undefined, null или логическое значение, то возвращаемое значение будет также NaN.
radixЦелое число от 2 до 36, указывающее основание числа в математических системах счисления. Если этот аргумент не указан, строки с префиксом "0x" или "0X" считаются шестнадцатеричными, все остальные строки считаются десятичными*. Необязательный параметр.
* - в зависимости от реализации значение праметра string, которое начинается с "0" может расцениваться как восьмеричная система счисления, так и десятичная. Во избежании ошибок рекомендуется явно указывать систему счисления (параметр radix).

Пример использования

Number.parseInt( "1" );          // Метод возвращает 1
Number.parseInt( "    1" );      // Метод возвращает 1
Number.parseInt( "    1    " );  // Метод возвращает 1
Number.parseInt( "1.23abc" );    // Метод возвращает 1
Number.parseInt( "1.23" );       // Метод возвращает 1
Number.parseInt( "123e-3" );     // Метод возвращает 123
Number.parseInt( "0.0123E+3" );  // Метод возвращает 0
Number.parseInt( "0xAA" );       // Метод возвращает 170
Number.parseInt( "N", 32 );      // Метод возвращает 23
Number.parseInt( "A", 16 );      // Метод возвращает 10
Number.parseInt( "F", 16 );      // Метод возвращает 15

Number.parseInt( "123FA", 10 );  // Метод возвращает 123
Number.parseInt( "123FA", 16 );  // Метод возвращает 74746

Number.parseInt( "A" );          // Метод возвращает NaN
Number.parseInt( Infinity );     // Метод возвращает NaN
Number.parseInt( -Infinity );    // Метод возвращает NaN
Number.parseInt( "abc1.23abc" ); // Метод возвращает NaN
Number.parseInt( "abc1.23" );    // Метод возвращает NaN
Number.parseInt( undefined );    // Метод возвращает NaN
Number.parseInt( true );         // Метод возвращает NaN
Number.parseInt( null );         // Метод возвращает NaN
Number.parseInt( [] );           // Метод возвращает NaN
Number.parseInt( {} );           // Метод возвращает NaN
Number.parseInt( "" );           // Метод возвращает NaN
Number.parseInt( " " );          // Метод возвращает NaN
JavaScript Number