剰余 (%)

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

構文

js
x % y

解説

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

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

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

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

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

正の値の剰余

js
13 % 5; // 3
1 % -2; // 1
1 % 2; // 1
2 % 3; // 2
5.5 % 2; // 1.5

3n % 2n; // 1n

負の値の剰余

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

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

NaN の剰余

js
NaN % 2; // NaN

無限大の剰余

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

仕様書

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

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
Remainder (%)

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

関連情報