setUTCFullYear, méthode
Mise à jour : novembre 2007
Définit la valeur de l'année de l'objet Date selon le temps universel.
function setUTCFullYear(numYear : Number [, numMonth : Number [, numDate : Number]])
Arguments
numYear
Obligatoire. Valeur numérique égale à l'année.numMonth
Facultatif. Valeur numérique égale au mois.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 getUTCMonth.
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 en heure locale, utilisez la méthode setFullYear.
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 setUTCFullYear.
function SetUTCFullYearDemo(newyear){
var d, s; //Declare variables.
d = new Date(); //Create Date object.
d.setUTCFullYear(newyear); //Set UTC full year.
s = "Current setting is ";
s += d.toUTCString();
return(s); //Return new setting.
}