| HTML-Dateien selbst erstellen
|  | Dokumentation: JavaScript
|  |  | JavaScript-Objektreferenz

# Date

Allgemeines zur Verwendung
Eigenschaften
Methoden

## Allgemeines zur Verwendung

Das Objekt Date ist für alle Berechnungen mit Datum und Zeit zuständig. Dabei gibt es, wie in der EDV üblich, einen fixen historischen Zeitpunkt, der intern als Speicherungs- und Berechnungsbasis dient. In JavaScript ist dies - wie in der C- und Unix-Welt - der 1. Januar 1970, 0.00 Uhr. Die Einheit, in der in JavaScript intern Zeit berechnet wird, ist eine Millisekunde.

### Instanz des Objekts Date erzeugen

Bevor Sie über JavaScript Zugriff auf die eingebauten Datums- und Uhrzeitfunktionen haben, müssen Sie eine Objektinstanz von Date erzeugen.

#### Schema:

Variante 1: `Objektname = new Date();` Variante 2: `Objektname = new Date("Monat Tag, Jahr Stunden:Minuten:Sekunden");` Variante 3: `Objektname = new Date(Jahr,Monat,Tag);` Variante 4: `Objektname = new Date(Jahr,Monat,Tag,Stunden,Minuten,Sekunden);`

#### Erläuterung:

Eine Objektinstanz von Date speichern Sie in einem selbst vergebenen Objektnamen. Hinter dem Namen folgt ein Istgleichzeichen. Dahinter folgt das reservierte Wort new und der Aufruf der Objektfunktion Date().

Benutzen Sie Variante 1, wenn Sie eine Objektinstanz erzeugen wollen, in der das zum Zeitpunkt der Programmausführung aktuelle Datum und die aktuelle Uhrzeit gespeichert werden soll. Benutzen Sie eine der Varianten 2 bis 4, wenn Sie das neue Datum-Objekt mit bestimmten Werten (also einem bestimmten Datum und einer bestimmten Uhrzeit) initialisieren wollen. Alle Initialisierungswerte wie Monat oder Minuten müssen Sie in Zahlenform angeben, also etwa 10 für Monat Oktober. Ausnahme: bei Variante (2) übergeben Sie die Initialisierungsdaten als Zeichenkette. Dabei wird der Monat in englischer Schreibweise angegeben, also beispielsweise october.

#### Beispiel:

    function bis2000()
    {
     jetzt = new Date();
     var Zeit = jetzt.getTime() / 1000;
     Jahr2000 = new Date(2000,1,1,0,0,0);
     var Endzeit = Jahr2000.getTime() / 1000;
     var Rest = Math.floor(Endzeit - Zeit);
     window.alert("Noch " + Rest + " Sekunden bis zum Jahr 2000");
    }

#### Erläuterung:

Das Beispiel zeigt eine vollständige JavaScript- Funktion. Die Funktion ermittelt die Anzahl Sekunden zwischen aktuellem Zeitpunkt und dem Jahr 2000. Dazu wird in jetzt eine neue Instanz von Date mit der aktuellen Zeit erzeugt. Für den Zeitpunkt, an dem das Jahr 2000 beginnt, wird eine zweite Objektinstanz von Date erzeugt, nämlich in Jahr2000. Dazu werden der Objektfunktion Date() entprechende Parameter übergeben. Über die beiden Objektnamen jetzt bzw. Jahr2000 wird dann die Methode Objektname.getTime() aufgerufen. getTime() liefert die Anzahl Millisekunden seit dem 1.1.1970 zurück. In der Variablen Zeit wird auf diese Weise die Anzahl Sekunden zwischen dem 1.1.1970 und dem aktuellen Zeitpunkt gespeichert, und in der Variablen Endzeit die Anzahl Sekunden zwischen dem 1.1.1970 und dem 1.1.2000. Die Differenz der beiden Werte wird in der Variablen Rest gespeichert und mit window.alert() in einem Meldungsfenster am Bildschirm ausgegeben.

## Eigenschaften

Das Objekt Date hat keine Eigenschaften.

## Methoden

Diese Methoden sind anwendbar, wenn zuvor eine Objektinstanz (= Objektname) von Date erzeugt wurde.

Objektname.getDate()
Liefert den Monatstag des Objekts Objektname als Zahl zurück, beispielsweise 2, wenn in Objektname der 2.10.1991, 23:59:00, gespeichert ist. Mit einer Anweisung wie var x = jetzt.getDate(); können Sie den Rückgabewert beispielsweise in einer Variablen x speichern.

Objektname.getDay()
Liefert den Wochentag des Objekts Objektname als Zahl zurück, beispielsweise 3, wenn in Objektname der 2.10.1991, 23:59:00, gespeichert ist, da der 2.10.1991 ein Mittwoch war. Die möglichen Rückgabewerte sind 0 (Sonntag), 1 (Montag), 2 (Dienstag), 3 (Mittwoch), 4 (Donnerstag), 5 (Freitag), 6 (Samstag).

Objektname.getHours()
Liefert die Stunden der Uhrzeit des Objekts Objektname als Zahl zurück, beispielsweise 23, wenn in Objektname der 2.10.1991, 23:59:00, gespeichert ist.

Objektname.getMinutes()
Liefert die Minuten der Uhrzeit des Objekts Objektname als Zahl zurück, beispielsweise 59, wenn in Objektname der 2.10.1991, 23:59:00, gespeichert ist.

Objektname.getMonth()
Liefert den Monat des Objekts Objektname als Zahl zurück, beispielsweise 9, wenn in Objektname der 2.10.1991, 23:59:00, gespeichert ist. Beachten Sie, daß die Monatszählung bei 0 beginnt. 0 ist also Januar, 1 ist Februar usw.

Objektname.getSeconds()
Liefert die Sekunden der Uhrzeit des Objekts Objektname als Zahl zurück, beispielsweise 0, wenn in Objektname der 2.10.1991, 23:59:00, gespeichert ist.

Objektname.getTime()
Liefert die Anzahl Millisekunden als Zahl zurück, die seit dem 1. Januar 1970, 0:00:00, bis zu dem in Objektname gespeicherten Zeitpunkt vergangen sind.

Objektname.getTimeZoneoffset()
Liefert den Unterschied zwischen lokaler Rechnerzeit und Greenwich Meridian Time (GMT) in Anzahl Minuten zurück.

Objektname.getYear()
Liefert das Jahr des Objekts Objektname als Zahl zurück, beispielsweise 1991, wenn in Objektname der 2.10.1991, 23:59:00, gespeichert ist.

Objektname.parse(Zeitpunkt)
Ermittelt aus einer zu übergebenden Zeichenkette Zeitpunkt die Anzahl Millisekunden, die zwischen dem 1.1.1970 0:00:00, und dem übergebenen Zeitpunkt verstrichen sind. Die Zeichenkette Zeitpunkt muß dem IETF-Standard folgen. Beispiele: "Wed, 2 Oct 1991 23:59:00 GMT", oder "Mon, 25 Dec 1995 13:30:00 GMT+0430" (Beispiel für Zeitzonen-Offset).

Objektname.setDate(Tag)
Ändert den in Objektname gespeicherten Monatstag auf den als Zahl zu übergebenden Monatstag. Sinnvolle Werte zwischen 1 und 31 übergeben.

Objektname.setHours(Stunden)
Ändert die in Objektname gespeicherten Stunden der Uhrzeit auf die als Zahl zu übergebenden Stunden. Werte zwischen 0 und 23 übergeben.

Objektname.setMinutes(Minuten)
Ändert die in Objektname gespeicherten Minuten der Uhrzeit auf die als Zahl zu übergebende Minutenzahl. Werte zwischen 0 und 59 übergeben.

Objektname.setMonth(Monat)
Ändert den in Objektname gespeicherten Monat auf den als Zahl zu übergebenden Monat. Werte zwischen 1 und 12 übergeben.

Objektname.setSeconds(Sekunden)
Ändert die in Objektname gespeicherten Sekunden der Uhrzeit auf die als Zahl zu übergebenden Sekunden. Werte zwischen 0 und 59 übergeben.

Objektname.setTime(Millisekunden)
Ändert den kompetten Inhalt von Objektname auf einmal durch Übergeben einer Zahl. Diese Zahl stellt die Anzahl Millisekunden seit dem 1.1.1970 0:00:00 dar. Übergeben Sie beispielsweise (8*365+2*366)*24*60*60*1000, um den Inhalt von Objektname auf den 1.1.1980 0:00:00 zu setzen.

Objektname.setYear(Jahr)
Ändert das in Objektname gespeicherte Jahr auf das als Zahl zu übergebende Jahr. Die Zahl muß größer oder gleich 1970 sein.

Objektname.toGMTString()
Wandelt die in Objektname gespeicherten Daten in eine Zeichenkette nach dem IETF-Standard um. Wenn beispielsweise in Objektname der 2.10.1991 23:59:00 gespeichert ist, liefert diese Methode zurück: "Wed, 2 Oct 1991 23:59:00 GMT".

Objektname.toLocaleString()
Wandelt die in Objektname gespeicherten Daten in eine Zeichenkette um. Die zurückgegebene Zeichenkette berücksichtigt die lokale Uhrzeit. Wenn beispielsweise in Objektname der 2.10.1991 23:59:00 gespeichert ist, liefert diese Methode zurück: "10/2/91 23:59".

Objektname.UTC(Jahr, Monat, Tag [, Stunden] [, Minuten] [,Sekunden])
Liefert die Anzahl Millisekunden zurück, die zwischen dem 1.1.1970 0:00:00 und dem übergebenen Zeitpunkt verstrichen sind. Alle Parameter sind als Zahlenwerte zu übergeben. Die Angabe der Datumswerte ist zwingend, die der Uhrzeitwerte optional.

| Blättern: |
Array |  |  | Math

| HTML-Dateien selbst erstellen
|  | Dokumentation: JavaScript
|  |  | JavaScript-Objektreferenz