---
title: Math.min()
slug: Web/JavaScript/Reference/Global_Objects/Math/min
translation_of: Web/JavaScript/Reference/Global_Objects/Math/min
original_slug: Web/JavaScript/Referencia/Objectes_globals/Math/min
---
<div>{{JSRef}}</div>

<p>La funció <strong><code>Math.min()</code></strong> retorna el més petit de zero o més nombres.</p>

<h2 id="Sintaxi">Sintaxi</h2>

<pre class="syntaxbox"><code>Math.min([<var>valor1</var>[, <var>valor2</var>[, ...]]])</code></pre>

<h3 id="Paràmetres">Paràmetres</h3>

<dl>
 <dt><code>valor1, valor2, ...</code></dt>
 <dd>Nombres.</dd>
</dl>

<h2 id="Descripció">Descripció</h2>

<p>Degut a que <code>min()</code> és un mètode estàtic de <code>Math</code>, sempre s'utilitza com a <code>Math.min()</code>, en comptes de com a mètode d'una instància de <code>Math</code> (<code>Math</code> no és un constructor).</p>

<p>Si no es proporciona cap argument, el resultat és {{jsxref("Infinity")}}.</p>

<p>Si al menys un dels arguments no pot ser convertit a nombre, el resultat és {{jsxref("NaN")}}.</p>

<h2 id="Exemples">Exemples</h2>

<h3 id="Utilitzar_Math.min()">Utilitzar <code>Math.min()</code></h3>

<p>Aquest codi troba el valor mínim de <code>x</code> i <code>y</code> i l'assigna a <code>z</code>:</p>

<pre class="brush: js">var x = 10, y = -20;
var z = Math.min(x, y);
</pre>

<h3 id="Limitar_un_nombre_amb_Math.min()">Limitar un nombre amb <code>Math.min()</code></h3>

<p>Sovint s'utilitza <code>Math.min()</code> per a limitar un valor de manera que sempre sigui igual o menor que un límit. Per exemple, aquest codi</p>

<pre class="brush: js">var x = f(foo);

if (x &gt; limit) {
  x = limit;
}
</pre>

<p>es podria escriure de la següent manera:</p>

<pre class="brush: js">var x = Math.min(f(foo), limit);
</pre>

<p>{{jsxref("Math.max()")}} es pot emprar d'una manera similar per a limitar un valor a l'altre límit.</p>

<h2 id="Especificacions">Especificacions</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Especificació</th>
   <th scope="col">Estat</th>
   <th scope="col">Comentaris</th>
  </tr>
  <tr>
   <td>{{SpecName('ES1')}}</td>
   <td>{{Spec2('ES1')}}</td>
   <td>Definició inicial. Implementat a JavaScript 1.0.</td>
  </tr>
  <tr>
   <td>{{SpecName('ES5.1', '#sec-15.8.2.12', 'Math.min')}}</td>
   <td>{{Spec2('ES5.1')}}</td>
   <td> </td>
  </tr>
  <tr>
   <td>{{SpecName('ES6', '#sec-math.min', 'Math.min')}}</td>
   <td>{{Spec2('ES6')}}</td>
   <td> </td>
  </tr>
 </tbody>
</table>

<h2 id="Compatibilitat_amb_navegadors">Compatibilitat amb navegadors</h2>

<div>{{CompatibilityTable}}</div>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Característica</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari</th>
  </tr>
  <tr>
   <td>Suport bàsic</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Característica</th>
   <th>Android</th>
   <th>Chrome for Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Suport bàsic</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
  </tr>
 </tbody>
</table>
</div>

<h2 id="Vegeu_també">Vegeu també</h2>

<ul>
 <li>{{jsxref("Math.max()")}}</li>
</ul>