Freigeben über


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.
}

Anforderungen

Version 3

Betrifft:

Date-Objekt

Siehe auch

Referenz

getFullYear-Methode

getUTCFullYear-Methode

setUTCFullYear-Methode