setFullYear-Methode
Aktualisiert: November 2007
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. Muss angegeben werden, wenn auch numDate verwendet wird.numDate
Optional. Ein dem Datum entsprechender numerischer Wert.
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:
function SetFullYearDemo(newyear){
var d, s; //Declare variables.
d = new Date(); //Create Date object.
d.setFullYear(newyear); //Set year.
s = "Current setting is ";
s += d.toLocaleString();
return(s); //Return new date setting.
}