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 setUTCMilliseconds()

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 setUTCMilliseconds() des instances de Date modifie les millisecondes pour cette date selon le temps universel.

Exemple interactif

const date1 = new Date("2018-01-24T12:38:29.069Z");

console.log(date1.getUTCMilliseconds());
// Résultat attendu : 69

date1.setUTCMilliseconds(420);

console.log(date1.getUTCMilliseconds());
// Résultat attendu : 420

Syntaxe

js
setUTCMilliseconds(millisecondsValue)

Paramètres

millisecondsValue

Un entier entre 0 et 999 représentant les millièmes de secondes.

Valeur de retour

Modifie l'objet Date en place et retourne son nouveau timestamp. Si millisecondsValue 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 un paramètre que vous définissez est en dehors de la plage attendue, setUTCMilliseconds() tente de mettre à jour les informations de date dans l'objet Date en conséquence. Par exemple, si vous utilisez 1100 pour millisecondsValue, les secondes stockées dans l'objet Date seront incrémentées de 1, et 100 sera utilisé pour les millisecondes.

Exemples

Utiliser la méthode setUTCMilliseconds()

js
const leGrandJour = new Date();
leGrandJour.setUTCMilliseconds(500);

Spécifications

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

Compatibilité des navigateurs

Voir aussi