Math.min()

Math.min() 静的関数は、引数に渡される最小の値、または引数のいずれかに数値以外があり、 1 に変換できない場合は NaN を返します。

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

構文

Math.min([value1[,value2[, ...]]]) 

引数

value1, value2, ...

最小値を選択され、返される 0 個以上の数値。

戻り値

与えられた数の最小の値です。1つ以上のパラメータを数値に変換することはできない場合、 NaN を返します。引数が与えられなかった場合の結果は Infinity です。

詳細

min() は Math オブジェクトの静的メソッドなので、自ら生成した Math オブジェクトのメソッドとしてではなく、常に Math.min() として使用するようにしてください（ Math はコンストラクタではありません）。

引数が与えられなかった場合の結果は Infinity です。

1 つでも数値に変換できないパラメータが渡された場合の結果は NaN です。

例

Math.min() を使う

変数 x と y の小さい方を z に代入します。

var x = 10, y = -20;
var z = Math.min(x, y);

Math.min() で値をクリップする

Math.min() は、しきい値以下に値をクリップするために用いられる事があります。

var x = f(foo);

if (x > boundary) {
    x = boundary;
}

上記コードは Math.min() を用いて次のように書き換える事ができます。

var x = Math.min( f(foo), boundary );

Math.max() を用いれば、反対に、しきい値以上に値をクリップする事ができます。

仕様

ブラウザー実装状況

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

関連情報

• Math.max()