setFullYear, méthode
Mise à jour : novembre 2007
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. Doit être fournie si l'argument numDate est spécifié.numDate
Facultatif. Valeur numérique égale à la date.
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 :
function SetFullYearDemo(newyear){
var d, s; //Declare variables.
d = new Date(); //Create Date object.
d.setFullYear(newyear); //Set year.
s = "Current setting is ";
s += d.toLocaleString();
return(s); //Return new date setting.
}