BigInt.prototype.toString() - JavaScript | MDN

サイドバーを切り替え

配色

OS のデフォルト
ライト
ダーク

日本語

言語を記憶もっと知る

BigInt.prototype.toString()

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2020年9月以降、すべてのブラウザーで利用可能です。

toString() は BigInt 値のメソッドで、指定した長整数 (BigInt) 値を表す文字列を返します。末尾の "n" は文字列の一部にはなりません。

試してみましょう

console.log(1024n.toString());
// 予想される結果: "1024"

console.log(1024n.toString(2));
// 予想される結果: "10000000000"

console.log(1024n.toString(16));
// 予想される結果: "400"

構文

js
toString()
toString(radix)

引数

radix 省略可

2 から 36 までの整数で、長整数の表現に使用する基数を指定します。デフォルトは 10 です。

例外

RangeError

toString() に 2 未満または 36 より大きな基数を与えられた場合。

解説

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

10 より大きな基数が指定された場合は、 9 より大きな数字をアルファベットで示します。例えば、16 進数（底が 16）では a から f が使用されます。

指定された長整数値が負の場合、符号は保持されます。基数が 2 の場合でも同様です。返される文字列は、長整数値の 2 進数表現に - 符号を付加したものであり、長整数値の 2 の補数ではありません。

toString() メソッドは、その this 値が BigInt プリミティブまたはラッパーオブジェクトである必要があります。他の this 値に対しては、長整数値への強制変換を試みることなく TypeError が発生します。

BigInt には [Symbol.toPrimitive]() メソッドがないため、JavaScript は BigInt オブジェクトが文字列のコンテキストで使用される際に自動的に toString() メソッドを呼び出します。メソッドを持たないため、JavaScript は BigInt オブジェクト が文字列を期待するコンテキスト（テンプレートリテラルなど）で使用される際に、自動的に toString() メソッドを呼び出します。ただし、BigInt のプリミティブ値は、文字列への型変換を行う際に toString() メソッドを参照しません。代わりに、最初の toString() 実装と同じアルゴリズムを用いて直接変換されます。

js
BigInt.prototype.toString = () => "Overridden";
console.log(`${1n}`); // "1"
console.log(`${Object(1n)}`); // "Overridden"

例

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"

仕様書

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

ブラウザーの互換性

ブラウザー互換性一覧表を表示するには、JavaScript を有効にしてください。

MDN の改良に協力

このページは役に立ちましたか？

はいいいえ

協力方法を知る

このページは MDN の貢献者によって 2025年11月30日に最終更新されました。

GitHub でこのページを表示 • このコンテンツに関する問題を報告