剰余演算子 (%) は、1 つ目のオペランドが 2 つ目のオペランドで除算されたときの余りである剰余を返します。これは常に被除数の符号を取ります。

試してみましょう

console.log(13 % 5);// Expected output: 3console.log(-13 % 5);// Expected output: -3console.log(4 % 2);// Expected output: 0console.log(-4 % 2);// Expected output: -0

構文

x % y

解説

% 演算子のオペランドは、数値型と長整数型の 2 つの型ででオーバーロードされています。 これは、まず両方のオペランドを数値に変換し、それらの型を調べます。両方のオペランドが長整数型になった場合は長整数型の剰余を実行し、そうでない場合は数値型の剰余を実行します。一方のオペランドが長整数型になり、他方が数値型になった場合はTypeError が発生します。

n % d の演算では、n を被除数、d を除数と呼びます。この演算処理は、オペランドのいずれかがNaN であるか、n が ±無限大であるか、またはd が ±0 である場合にNaN を返します。

両方のオペランドが 0 ではなく有限であるとき、剰余r はr := n - d * q として計算されます。ここでq は、r ができるだけ 0 に近く、被除数n と同じ符号を持つ整数です。

なお、多くの言語では '%' はリマインダー演算子ですが、言語によっては（例えばPython や Perl では）モジュロ演算子になります。モジュロはk := n - d * q と定義されます。ここでq はk が除数d と同じ符号を持ち、かつ使用可能な限り 0 に近い整数です。 2 つのオペランドの符号が同じであれば、両者は等価になりますが、オペランドの符号が異なる場合、オペランドの符号が異なる場合、モジュロの結果は符号が常に除数 と同じになり、リマインダーは被除数と同じになります。 JavaScript でモジュロを得るには、n % d の代わりに((n % d) + d) % d を使用してください。 JavaScript では、ビット単位のシフト演算子（<<、>> など）の 2 つ目のオペランドを正規化するために、（専用の演算子のない）モジュロ演算が使用され、オフセットが常に正の値になります。

長整数型の除算では、被除数y が0n の場合にRangeError が発生します。これはゼロによる剰余はNaN を返しますが、長整数にはNaN の概念がないからです。

例

正の値の剰余

13 % 5; // 31 % -2; // 11 % 2; // 12 % 3; // 25.5 % 2; // 1.53n % 2n; // 1n

負の値の剰余

-13 % 5; // -3-1 % 2; // -1-4 % 2; // -0-3n % 2n; // -1n

NaN の剰余

NaN % 2; // NaN

無限大の剰余

Infinity % 2; // NaNInfinity % 0; // NaNInfinity % Infinity; // NaN2 % Infinity; // 20 % Infinity; // 0

仕様書

ブラウザーの互換性

関連情報

• 加算 (+)
• 減算 (-)
• 除算 (/)
• 乗算 (*)
• べき乗 (**)
• インクリメント (++)
• デクリメント (--)
• 単項マイナス (-)
• 単項プラス (+)
• Remainder operator vs. modulo operator by Dr. Axel Rauschmayer (2019)