Share via


setFullYear, méthode

Définit la valeur de l'année de l'objet Date en heure locale.

function setFullYear(numYear : Number [, numMonth Number [, numDate Number]])

Arguments

  • numYear
    Obligatoire. Valeur numérique égale à l'année.

  • numMonth
    Facultatif. 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. Doit être fournie si l'argument numDate est spécifié.

  • numDate
    Facultatif. Valeur numérique correspondant au jour du mois.

Notes

Toutes les méthodes set acceptant des arguments facultatifs utilisent la valeur retournée par les méthodes get correspondantes lorsqu'un argument facultatif n'est pas spécifié. Par exemple, si l'argument facultatif numMonth n'est pas spécifié, JScript emploie la valeur retournée par la méthode getMonth.

En outre, si la valeur d'un argument est en dehors de la plage de sélection ou si elle est négative, les autres valeurs stockées sont modifiées en conséquence.

Pour définir l'année selon le temps universel (UTC, Universal Time Coordinated), utilisez la méthode setUTCFullYear.

La plage de sélection des années prise en charge dans l'objet Date couvre environ 285 616 ans avant ou après 1970.

Exemple

L'exemple ci-dessous illustre l'utilisation de la méthode setFullYear :

var dtFirst = new Date();
dtFirst.setFullYear(2007);

var dtSecond = new Date();
// 10 is the value for November. 
dtSecond.setFullYear(2008, 10, 3); 

Configuration requise

Version 3

S'applique à :

Date, objet

Voir aussi

Référence

getFullYear, méthode

Méthode getUTCFullYear

setUTCFullYear, méthode