Math.trunc()

試してみましょう

console.log(Math.trunc(13.37));
// 予想される結果: 13

console.log(Math.trunc(42.84));
// 予想される結果: 42

console.log(Math.trunc(0.123));
// 予想される結果: 0

console.log(Math.trunc(-0.123));
// 予想される結果: -0

構文

Math.trunc(x)

引数

x

数値。

返値

x の整数部です。

解説

Math.trunc() の処理は、他の 3 つの Math メソッド、Math.floor()、Math.ceil()、Math.round() よりも直感的です。引数が正の数か負の数かに関わらず、小数点とその右側の桁を切り詰め（切り捨て）ます。

trunc() は Math オブジェクトの静的なメソッドなので、自ら生成した Math オブジェクトのメソッドとしてではなく、常に、Math.trunc() として使用してください (Math オブジェクトにはコンストラクタがありません)。

例

Math.trunc() の使用

Math.trunc(-Infinity); // -Infinity
Math.trunc("-1.123"); // -1
Math.trunc(-0.123); // -0
Math.trunc(-0); // -0
Math.trunc(0); // 0
Math.trunc(0.123); // 0
Math.trunc(13.37); // 13
Math.trunc(42.84); // 42
Math.trunc(Infinity); // Infinity

ビット単位の no-op を使った数値の切り捨て

ビット演算はオペランドを32ビット整数に変換するため、従来は浮動小数点数を切り捨てるために利用されてきました。一般的なテクニックは以下の通りです。

const original = 3.14;
const truncated1 = ~~original; // 二重否定
const truncated2 = original & -1; // Bitwise AND with -1
const truncated3 = original | 0; // Bitwise OR with 0
const truncated4 = original ^ 0; // Bitwise XOR with 0
const truncated5 = original >> 0; // Bitwise shifting by 0

これは本質的に toInt32 であり、 Math.trunc とは異なることに注意してください。値が -2³¹ - 1 < value < 2³¹ (-2147483649 < value < 2147483648) を満たさない場合、変換がオーバーフローしてしまいます。

const a = ~~2147483648; // -2147483648
const b = ~~-2147483649; // 2147483647
const c = ~~4294967296; // 0

Math.trunc() の代用として ~~ を使うのは、入力の範囲が 32 ビット整数の範囲に収まっていると確信できる場合だけにしてください。

仕様書

ブラウザーの互換性

関連情報

• Math.trunc のポリフィル (core-js)
• Math.abs()
• Math.ceil()
• Math.floor()
• Math.round()
• Math.sign()