Back

# Math.min

## Math.min

The `Math.min()` function returns the smallest of zero or more numbers.

## Syntax

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

### Parameters

`value1, value2, ...`
Numbers.

## Description

Because `min()` is a static method of `Math`, you always use it as `Math.min()`, rather than as a method of a `Math` object you created (`Math` is not a constructor).

If no arguments are given, the result is Infinity.

If at least one of arguments cannot be converted to a number, the result is NaN.

## Examples

### Using `Math.min()`

This finds the min of `x` and `y` and assigns it to `z`:

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

### Clipping a value with `Math.min()`

`Math.min()` is often used to clip a value so that it is always less than or equal to a boundary. For instance, this

```var x = f(foo);

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

may be written as this

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

Math.max() can be used in a similar way to clip a value at the other end.