Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Date : méthode setUTCMinutes()

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

La méthode setUTCMinutes() des instances de Date modifie les minutes pour cette date selon le temps universel.

Exemple interactif

const date1 = new Date("December 31, 1975, 23:15:30 GMT+11:00");

console.log(date1.getUTCMinutes());
// Résultat attendu : 15

date1.setUTCMinutes(25);

console.log(date1.getUTCMinutes());
// Résultat attendu : 25

Syntaxe

js
setUTCMinutes(minutesValue)
setUTCMinutes(minutesValue, secondsValue)
setUTCMinutes(minutesValue, secondsValue, msValue)

Paramètres

minutesValue

Un entier compris entre 0 et 59 représentant les minutes.

secondsValue Facultatif

Un entier compris entre 0 et 59 représentant les secondes. Si vous définissez secondsValue, vous devez aussi définir minutesValue.

msValue Facultatif

Un entier compris entre 0 et 999 représentant les millisecondes. Si vous définissez msValue, vous devez aussi définir minutesValue et secondsValue.

Valeur de retour

Modifie l'objet Date en place et retourne son nouveau timestamp. Si un paramètre vaut NaN (ou d'autres valeurs qui sont contraintes en NaN, comme undefined), la date est définie sur Date invalide et NaN est retourné.

Description

Si vous ne définissez pas les paramètres secondsValue et msValue, les valeurs retournées par les méthodes getUTCSeconds() et getUTCMilliseconds() sont utilisées.

Si un paramètre que vous définissez est en dehors de la plage attendue, setUTCMinutes() tente de mettre à jour les informations de date dans l'objet Date en conséquence. Par exemple, si vous utilisez 100 pour secondsValue, les minutes seront incrémentées de 1 (minutesValue + 1), et 40 sera utilisé pour les secondes.

Exemples

Utiliser la méthode setUTCMinutes()

js
const leGrandJour = new Date();
leGrandJour.setUTCMinutes(43);

Spécifications

Specification
ECMAScript® 2026 Language Specification
# sec-date.prototype.setutcminutes

Compatibilité des navigateurs

Voir aussi