Share via


setMonth, méthode

Définit la valeur du mois de l'objet Date en heure locale.

function setMonth(numMonth : Number [, dateVal : Number]) 

Arguments

  • numMonth
    Obligatoire. Valeur numérique égale au mois. La valeur pour janvier est 0 et les valeurs des autres mois suivent celle-ci de manière consécutive.

  • dateVal
    Facultatif. Valeur numérique représentant le jour du mois. Si cette valeur n'est pas fournie, la valeur employée est celle qui est retournée par un appel à la méthode getDate.

Notes

Pour définir le mois selon le temps universel (UTC, Universal Time Coordinated), utilisez la méthode setUTCMonth.

Si la valeur de l'argument numMonth est supérieure à 11 (janvier correspondant au mois 0), ou si elle est négative, l'année stockée est modifiée en conséquence. Par exemple, si la date stockée est « 5 Jan 1996 » et que la méthode setMonth(14) est appelée, la date devient « 5 Mar 1997 ».

La méthode setFullYear peut être utilisée pour définir l'année, le mois et le jour du mois.

Exemple

L'exemple suivant illustre l'utilisation de la méthode setMonth.

function SetMonthDemo(newmonth){
    var d = new Date();
    d.setMonth(newmonth);

    var s = d.toLocaleString(); 
    return(s);
}

Configuration requise

Version 1

S'applique à :

Date, objet

Voir aussi

Référence

getMonth, méthode

getUTCMonth, méthode

setUTCMonth, méthode