setUTCFullYear-Methode
Aktualisiert: November 2007
Legt den Wert des Jahres im Date-Objekt unter Verwendung von UTC (Universal Coordinated Time, koordinierte Weltzeit) fest.
function setUTCFullYear(numYear : Number [, numMonth : Number [, numDate : Number]])
Argumente
numYear
Erforderlich. Ein dem Jahr entsprechender numerischer Wert.numMonth
Optional. Ein dem Monat entsprechender numerischer Wert.numDate
Optional. Ein dem Datum entsprechender numerischer Wert.
Hinweise
Alle set-Methoden, denen optionale Argumente übergeben werden, verwenden den durch die entsprechenden get-Methoden zurückgegebenen Wert, wenn kein optionales Argument angegeben wurde. Wenn z. B. das numMonth-Argument optional, aber nicht angegeben ist, verwendet JScript den von der getUTCMonth-Methode zurückgegebenen Wert.
Wenn darüber hinaus der Wert eines Arguments größer als dessen Bereich oder eine negative Zahl ist, werden andere gespeicherte Werte entsprechend geändert.
Um das Jahr unter Verwendung der Ortszeit festzulegen, verwenden Sie die setFullYear-Methode.
Der von Date-Objekten unterstützte Bereich beträgt etwa 285.616 Jahre vor und nach 1970.
Beispiel
Das folgende Beispiel veranschaulicht die Verwendung der setUTCFullYear-Methode.
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.
}