JavaScript/Objekte/Date/setFullYear

Die Methode setFullYear() ändert die Jahreszahl, die in einem Datumsobjekt gespeichert ist. Das neue Jahr ist als Parameter zu übergeben.

Syntax

dateObj.setFullYear(jahr[, monat[, tag]])

• jahr: ganze Zahl, die den numerischen Wert des Jahres angibt

optional:

• monat: ganze Zahl zwischen 0 und 11, die den Monat von Januar bis Dezember angibt.
• tag: ganze Zahl zwischen 1 und 31, welche den Tag des Monats angibt. (Wenn der dieser Parameter angegeben wird, muss auch ein Wert für Monat angegeben werden.)

Rückgabewert ist die Anzahl der Millisekunden zwischen dem 1. Januar 1970 00:00:00 UTC und dem geänderten Date-Objekt.

Anwendungsbeispiel

Beispiel ansehen …

    var zeit = new Date(),
        zukunft = zeit.setFullYear(2037),
        ausgabe= 'Irgendwann schreiben wir das Jahr ' + zeit.getUTCFullYear();
    document.getElementById('datum').innerHTML = ausgabe;

Das Beispiel erzeugt ein neues Datumsobjekt zeit. Dann wird die Methode setFullYear() auf den Objektnamen zeit angewendet. Im Beispiel wird das Jahr auf 2037 gesetzt. Anschließend wird das Ergebnis zur Kontrolle ins Dokument geschrieben.

Siehe auch

• Date.prototype.getFullYear
• Date.prototype.getUTCFullYear
• Date.prototype.setUTCFullYear

Weblinks

• ECMAScript: ECMASript 1st Edition 1997 (pdf) date.prototype.setfullyear
• MDN: Global_Objects/Date/setFullYear