JavaScript метод Number.prototype.toString()

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

JavaScript метод toString() возвращает строковое представление переданного числа (объекта Number).

Проверьте поведение в редактируемом примере.

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

Спецификация: ecma262

Поддерживается во всех основных браузерах с 2015 года.

Показать браузеры
Совместимостьjavascript.builtins.Number.toString
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
toString✓1✓12✓1✓4✓1✓18✓4✓10.1✓1✓1.0✓4.4✓1

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

JavaScript синтаксис

JavaScript
// основание числа соответствует десяти
num.toString();

// с указанием определенного основания числа
num.toString( radix );

Спецификация

ECMAScript: Number.prototype.toString()

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

Number: справочные сведения
Параметр Описание
radix Целое число от 2 до 36, указывающее основание числа в математических системах счисления. Необязательный параметр.
Если значение параметра radix отсутствует, то значение параметра расценивается равным 10. Если значение параметра radix является нецелым числовым значением, то оно будет усечено в сторону нуля до целого числа.

Исключения

Number: справочные сведения
Тип исключения Описание
RangeError Возникает в том случае, если параметр radix не находится в диапазоне от 2 до 36 (включительно).

Возвращаемое значение и особенности

Возвращает строку. Основание по умолчанию 10; undefined тоже выбирает 10. При основании 10 экспоненциальная запись используется для ненулевых значений с модулем меньше 1e-6 или не меньше 1e21. Для -0 возвращается "0". Метод, вызванный через call() для нечислового получателя, выбрасывает TypeError.

Примеры, попробуйте сами

Как представить число в разных системах счисления

Измените число и radix от 2 до 36; сравните строку и ошибку при неподходящем основании.

index.html
HTML
<p>Результат выполнения выводится в консоль.</p>
main.js
JavaScript
var num = 123 // инициализируем числовую переменную

try {
    console.log(num.toString())
} catch (error) {
    console.log(error.name)
} // возвращаемое значение "123"
try {
    console.log(num.toString(10))
} catch (error) {
    console.log(error.name)
} // возвращаемое значение "123"
try {
    console.log(num.toString(10.1))
} catch (error) {
    console.log(error.name)
} // возвращаемое значение "123"
try {
    console.log(num.toString(10.9))
} catch (error) {
    console.log(error.name)
} // возвращаемое значение "123"

try {
    console.log(num.toString(8))
} catch (error) {
    console.log(error.name)
} // возвращаемое значение "173"
try {
    console.log(num.toString(16))
} catch (error) {
    console.log(error.name)
} // возвращаемое значение "7b"
try {
    console.log(num.toString(32))
} catch (error) {
    console.log(error.name)
} // возвращаемое значение "3r"

try {
    console.log(num.toString(-1))
} catch (error) {
    console.log(error.name)
} // RangeError
try {
    console.log(num.toString(1))
} catch (error) {
    console.log(error.name)
} // RangeError
try {
    console.log(num.toString(37))
} catch (error) {
    console.log(error.name)
} // RangeError

try {
    console.log((123.456).toString(16))
} catch (error) {
    console.log(error.name)
} // возвращаемое значение "7b.74bc6a7ef9dc"
// 123.toString() — SyntaxError: точка читается как дробная часть; пишите (123).toString() или 123..toString()
try {
    console.log((123).toString())
} catch (error) {
    console.log(error.name)
} // возвращаемое значение "123"

try {
    console.log((1.11e1).toString())
} catch (error) {
    console.log(error.name)
} // возвращаемое значение "11.1"
try {
    console.log((1.11e-1).toString())
} catch (error) {
    console.log(error.name)
} // возвращаемое значение "0.111"