Date : méthode setUTCDate()

Exemple interactif

const event = new Date("August 19, 1975 23:15:30 GMT-3:00");

console.log(event.getUTCDate());
// Résultat attendu : 20

event.setUTCDate(19);

console.log(event.getUTCDate());
// Résultat attendu : 19

Syntaxe

setUTCDate(dateValue)

Paramètres

dateValue

Un entier de 1 à 31 représentant un jour dans le mois.

Valeur de retour

Modifie l'objet Date en place et retourne son nouveau timestamp. Si dateValue 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 la valeur dateValue est en dehors de la plage des jours du mois, setDate() mettra à jour l'objet Date en conséquence.

Par exemple, si 0 est fourni pour dateValue, la date sera définie au dernier jour du mois précédent. Si vous utilisez 40 pour dateValue et que le mois stocké dans l'objet Date est juin, le jour sera changé en 10 et le mois sera incrémenté à juillet.

Si un nombre négatif est fourni pour dateValue, la date sera définie en comptant à rebours à partir du dernier jour du mois précédent. -1 aura pour effet de définir la date à 1 jour avant le dernier jour du mois précédent.

Exemples

Utiliser la méthode setUTCDate()

const leGrandJour = new Date();
leGrandJour.setUTCDate(20);

Spécifications

Compatibilité des navigateurs

Voir aussi

• La méthode Date.prototype.getUTCDate()
• La méthode Date.prototype.setDate()