このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
Math.min()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
Math.min() は静的メソッドで、入力引数として与えられた数値のうち最小の値を返します。引数がない場合はInfinity を返します。
試してみましょう
console.log(Math.min(2, 3, 1));// 予想される結果: 1console.log(Math.min(-2, -3, -1));// 予想される結果: -3const 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); // -20Math.min() で値をクリップする
Math.min() は、次のようにしきい値以下に値をクリップするために用いられることがあります。
js
let x = f(foo);if (x > boundary) { x = boundary;}これは次のように書くことができます。
js
const x = Math.min(f(foo), boundary);Math.max() を用いれば、反対に、しきい値以上に値をクリップすることができます。
仕様書
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-math.min |