Share via


setUTCFullYear, méthode

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. 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 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 suivant illustre l'utilisation de la méthode setUTCFullYear.

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

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

print (dtFirst.toUTCString());
print (dtSecond.toUTCString());

Configuration requise

Version 3

S'applique à :

Date, objet

Voir aussi

Référence

getFullYear, méthode

Méthode getUTCFullYear

setFullYear, méthode