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

構文

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

引数

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

戻り値

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

詳細

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

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

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

Math.min() を使う

変数 xy の小さい方を 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() を用いれば、反対に、しきい値以上に値をクリップする事ができます。

仕様

仕様書 策定状況 コメント
ECMAScript 1st Edition (ECMA-262) 標準 初期定義です。JavaScript 1.0 で実装されました。
ECMAScript 5.1 (ECMA-262)
Math.min の定義
標準  
ECMAScript 2015 (6th Edition, ECMA-262)
Math.min の定義
標準  
ECMAScript Latest Draft (ECMA-262)
Math.min の定義
ドラフト  

ブラウザー実装状況

Update compatibility data on GitHub
デスクトップモバイルサーバー
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeEdge MobileAndroid 版 FirefoxAndroid 版 OperaiOS 版 SafariSamsung InternetNode.js
基本対応Chrome 完全対応 ありEdge 完全対応 ありFirefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありEdge Mobile 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 ありnodejs 完全対応 あり

凡例

完全対応  
完全対応

関連情報

ドキュメントのタグと貢献者

このページの貢献者: segayuu, teoli, ethertank, Potappo
最終更新者: segayuu,