剰余 (%)

Baseline Widely available

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

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

試してみましょう

console.log(13 % 5);
// Expected output: 3

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

console.log(4 % 2);
// Expected output: 0

console.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; // 3
1 % -2; // 1
1 % 2; // 1
2 % 3; // 2
5.5 % 2; // 1.5

3n % 2n; // 1n

負の値の剰余

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

-3n % 2n; // -1n

NaN の剰余

NaN % 2; // NaN

無限大の剰余

Infinity % 2; // NaN
Infinity % 0; // NaN
Infinity % Infinity; // NaN
2 % Infinity; // 2
0 % Infinity; // 0

仕様書

Specification
ECMAScript® 2026 Language Specification # sec-multiplicative-operators