setUTCFullYear-Methode
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. Januar hat den Wert 0, und die nachfolgenden Werte geben die anderen Monate an. Muss angegeben werden, wenn auch numDate angegeben wird.numDate
Optional. Ein dem Tag des Monats 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:
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());