setFullYear-Methode
Legt den Wert des Jahres im Date-Objekt unter Verwendung der Ortszeit fest.
function setFullYear(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 verwendet wird.numDate
Optional. Ein numerischer Wert, der gleich dem Tag des Monats ist.
Hinweise
Alle set-Methoden, denen optionale Argumente übergeben werden, verwenden den von den entsprechenden get-Methoden zurückgegebenen Wert, wenn das optionale Argument nicht angegeben wurde. Wenn z. B. das numMonth-Argument optional, aber nicht angegeben ist, verwendet JScript den von der getMonth-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 koordinierten Weltzeit (Universal Coordinated Time, UTC) festzulegen, verwenden Sie die setUTCFullYear-Methode.
Der Bereich der im Date-Objekt unterstützten Jahre beträgt etwa 285.616 Jahre in beide Richtungen ab 1970.
Beispiel
Das folgende Beispiel veranschaulicht die Verwendung der setFullYear-Methode:
var dtFirst = new Date();
dtFirst.setFullYear(2007);
var dtSecond = new Date();
// 10 is the value for November.
dtSecond.setFullYear(2008, 10, 3);