Math.min()
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
Math.min() は静的メソッドで、入力引数として与えられた数値のうち最小の値を返します。引数がない場合は Infinity を返します。
試してみましょう
console.log(Math.min(2, 3, 1));
// 予想される結果: 1
console.log(Math.min(-2, -3, -1));
// 予想される結果: -3
const array = [2, 3, 1];
console.log(Math.min(...array));
// 予想される結果: 1
構文
js
Math.min()
Math.min(value1)
Math.min(value1, value2)
Math.min(value1, value2, /* …, */ valueN)
引数
value1, …,valueN-
最小値が選択して返される 0 個以上の数値です。
返値
与えられた数のうちの最小の値です。1 つ以上の引数を数値に変換することができなかった場合は NaN を返します。引数が与えられなかった場合の結果は Infinity です。
解説
min() は Math の静的メソッドなので、常に Math.min() として使用し、自分で Math オブジェクトを生成してそのメソッドとして使用しないでください。 (Math にはコンストラクターがありません)。
Math.min.length は 2 であり、少なくとも 2 つの引数を処理するように設計されていることを弱く示唆しています。
例
Math.min() の使用
変数 x と y の小さい方を z に代入します。
js
const x = 10;
const y = -20;
const z = Math.min(x, y); // -20
Math.min() で値をクリップする
Math.min() は、次のようにしきい値以下に値をクリップするために用いられることがあります。
js
let x = f(foo);
if (x > boundary) {
x = boundary;
}
これは次のように書くことができます。
js
const x = Math.min(f(foo), boundary);
Math.max() を用いれば、反対に、しきい値以上に値をクリップすることができます。
仕様書
| 仕様書 |
|---|
| ECMAScript® 2027 Language Specification # sec-math.min |