Math.max()

Math.max() 関数は、引数として与えた複数の数の中で最大の数を返します。

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.max([value1[, value2[, ...]]])

引数

value1, value2, ...

複数の数値。

戻り値

与えられた数値の中で最大のものを返します。1 つでも数値に変換できない引数があれば、NaN を返します。

解説

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

引数が与えられなかった場合、その結果は -Infinity になります。

1 つでも数値に変換できない引数があれば、結果は NaN になります。

例

Math.max() の使用

Math.max(10, 20);   //  20
Math.max(-10, -20); // -10
Math.max(-10, 20);  //  20

配列の中で最大の要素

Array.reduce() を使うことで、数値の配列の中で最大の要素を取得できます。それぞれの値を比較するには下記のようにします。

var arr = [1,2,3];
var max = arr.reduce(function(a, b) {
    return Math.max(a, b);
});

下記の関数では、Function.prototype.apply() を使って配列の最大値を取得しています。getMaxOfArray([1, 2, 3]) は Math.max(1, 2, 3) と同じですが、getMaxOfArray() は配列に対して使用できます。この方法は小規模な配列に対して使うべきです。

function getMaxOfArray(numArray) {
  return Math.max.apply(null, numArray);
}

新しいスプレッド構文は、apply を使う方法の短縮版です。

var arr = [1, 2, 3];
var max = Math.max(...arr);

しかし、要素の数が多い大規模な配列では、スプレッド構文 (...) と apply のどちらも、失敗するか誤った値を返す可能性があります。なぜなら、配列の要素を関数の引数として渡そうとしているからです。詳細は apply をビルトイン関数と共に利用する をご覧ください。reduce を使う方法ならば問題ありません。

仕様

ブラウザー実装状況

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.min()