Math.min()
Math.min()
は静的関数で、引数で渡されたもののうち最小の値を返します。または引数のいずれかが数値以外で、数値に変換できない場合は 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 個以上の数値です。
返値
解説
min()
は Math
の静的メソッドなので、常に Math.min()
として使用し、自分で Math
オブジェクトを生成してそのメソッドとして使用しないでください。 (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;
}
これは次のように書くことができます。
var x = Math.min(f(foo), boundary);
Math.max()
を用いれば、反対に、しきい値以上に値をクリップすることができます。
仕様書
ブラウザーの互換性
BCD tables only load in the browser