BigInt.prototype.toString()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.

toString() メソッドは、指定した BigInt オブジェクトを表す文字列を返します。末尾の "n" は文字列の一部にはなりません。

試してみましょう

構文

js
toString();
toString(radix);

引数

radix省略可

オプション。数値を表す底に指定する 2 以上 36 以下の整数（基数）。

返値

指定した BigInt オブジェクトを表す文字列。

例外

RangeError

toString() に 2 未満または 36 より大きな基数を与えられた場合、RangeError が発生します。

解説

BigInt オブジェクトは Object の toString() メソッドをオーバーライドします。つまり、 Object.prototype.toString() を継承しません。 BigInt オブジェクトでは、toString() メソッドは指定された基数によるオブジェクトの文字列表現を返します。

toString() メソッドは 1 番目の引数を解釈し、指定された基数（底）による文字列表現を返そうとします。10 より大きな基数が指定された場合は、 9 より大きな数値をアルファベットで示します。例えば、16 進数（底が 16）では a から f が使用されます。

radix が指定されなかった場合は、基数として 10 が指定されたとみなします。

bigIntObj が負の数だった場合、符号は保持されます。これは、基数が 2 だった場合にも適用されます。つまり、返値の文字列は、bigIntObj の正の 2 進数表現の先頭に - 符号が付いたものであり、bigIntObj の 2 の補数ではありません。

例

toString の使用

js
17n.toString(); // '17'
66n.toString(2); // '1000010'
254n.toString(16); // 'fe'
-10n.toString(2); // -1010'
-0xffn.toString(2); // '-11111111'

BigInt における負の 0

整数に負の 0 が存在しないのと同様に、BigInt には負の 0 がありません。 -0.0 は JavaScript の Number 型にのみ現れる、IEEE 浮動小数点数の概念です。

js
(-0n).toString(); // '0'
BigInt(-0).toString(); // '0'

仕様書

Specification
ECMAScript Language Specification
# sec-bigint.prototype.tostring

ブラウザーの互換性

BCD tables only load in the browser

関連情報