SELFHTML: JavaScript / Objektreferenz / Date
Description: (SELFHTML 7.0) Das JavaScript-Objekt Date
Keywords: SELFHTML, JavaScript, Objekt, Date-Objekt

SELFHTML/Quickbar JavaScript Objektreferenz

| ## Date
| Allgemeines zur Verwendung Methoden: getDate() (Monatstag ermitteln) getDay() (Wochentag ermitteln) getHours() (Stundenteil der Uhrzeit ermitteln) getMinutes() (Minutenteil der Uhrzeit ermitteln) getMonth() (Monat ermitteln) getSeconds() (Sekundenteil der Uhrzeit ermitteln) getTime() (Zeitpunkt ermitteln) getTimezoneOffset() (Zeitzonenabweichung der Lokalzeit ermitteln) getYear() (Jahr ermitteln) parse() (Millisekunden seit dem 1.1.1970 ermitteln) setDate() (Monatstag setzen) setHours() (Stunden der Uhrzeit setzen) setMinutes() (Minuten der Uhrzeit setzen) setSeconds() (Sekunden der Uhrzeit setzen) setTime() (Datum und Uhrzeit setzen) setYear() (Datum und Uhrzeit setzen) toGMTString() (Zeitpunkt in GMT-Format konvertieren) toLocaleString() (Zeitpunkt in lokales Format konvertieren) UTC() (GMT-Zeit seit dem 1.1.1970 ermitteln)

## Date: 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.

Bevor Sie über JavaScript Zugriff auf die eingebauten Datums- und Uhrzeitfunktionen haben, müssen Sie ein neues `Date`-Objekt erzeugen. Dabei gibt es mehrere Varianten.

### 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 neues `Date`-Objekts 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 die 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`. Wenn Sie einen Monat als Zahlenwert übergeben, so wie in den Varianten 3 und 4, müssen Sie bei 0 zu zählen beginnen. Für Januar müssen Sie also 0 übergeben, für Februar 1, und für Dezember 11.

### Beispiel:

    function bis2000()
    {
     jetzt = new Date();
     var Zeit = jetzt.getTime() / 1000;
     Jahr2000 = new Date(2000,0,1,0,0,0);
     var Endzeit = Jahr2000.getTime() / 1000;
     var Rest = Math.floor(Endzeit - Zeit);
     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 `alert()` in einem Meldungsfenster am Bildschirm ausgegeben.

### Beachten Sie:

Alle Methoden, mit denen Sie einen aktuellen Zeitpunkt oder einen Teil davon, etwa den Wochentag oder den Monat, ermitteln können, beziehen sich auf die Zeit, die auf der Systemzeit des Anwenderrechners basiert. Denn JavaScript wird beim Anwender von dessen Browser ausgeführt. Die aktuelle Systemzeit des Server-Rechners können Sie mit JavaScript nicht ermitteln - das geht beispielsweise mit einem CGI-Script.

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

### Beispiel:

    <html><head><title>Test</title>
    </head><body>
    <script language="JavaScript">
    jetzt = new Date();
    Tag = jetzt.getDate();
    document.write("<table border bgcolor=#CCFFFF><tr><td><font size=7>");
    document.write(Tag + "</font></td></tr></table>");
    </script>
    </body></html>

### Erläuterung:

Das Beispiel erzeugt ein neues Datumobjekt mit dem aktuellen Zeitpunkt in dem Objektnamen `jetzt`. Mit `jetzt.getDate()` wird das aktuelle Tagesdatum innerhalb des Monats ermittelt. Der Rückgabewert des Aufrufs wird in der Variablen `Tag` gespeichert. Anschließend wird mit Hilfe von `document.write()` dynamisch eine kleine Tabelle in die Datei geschrieben, in der das aktuelle Tagesdatum formatiert ausgegeben wird.

## getDay()

Liefert den Wochentag des Objekts `Objektname` als Zahl zurück, und zwar in Form von Zahlen zwischen 0 (für Sonntag), 1 (für Montag) usw. bis 6 (für Samstag), also beispielsweise 3, wenn in `Objektname` der 2.10.1991, 23:59:00, gespeichert ist, da der 2.10.1991 ein Mittwoch war.

### Beispiel:

    <html><head><title>Test</title>
    </head><body>
    <script language="JavaScript">
    jetzt = new Date();
    TagInWoche = jetzt.getDay();
    var Wochentag = new
    Array("Sonntag","Montag","Dienstag","Mittwoch","Donnerstag","Freitag","Samstag");
    document.write("<table border bgcolor=#CCFFFF><tr><td><b>");
    document.write(Wochentag[TagInWoche] + "</b></td></tr></table>");
    </script>
    </body></html>

### Erläuterung:

Das Beispiel erzeugt ein neues Datumobjekt mit dem aktuellen Zeitpunkt in dem Objektnamen `jetzt`. Mit `jetzt.getDay()` wird der numerische Wert des aktuellen Wochentags ermittelt. Der Rückgabewert des Aufrufs wird in der Variablen `TagInWoche` gespeichert. Es soll jedoch ein richtiger Wochentagsname ausgegeben werden. Deshalb wird im Beispiel ein Array-Objekt mit deutschen Wochentagnamen erzeugt. Das erste Element ist dabei der Sonntag, da der Rückgabewert von `getDay()` ebenfalls intern mit Sonntag als erstem Wochentag rechnet.
Anschließend wird mit Hilfe von `document.write()` dynamisch eine kleine Tabelle in die Datei geschrieben, in der das aktuelle Tagesdatum formatiert ausgegeben wird. Beachten Sie, daß die Variable `TagInWoche` dabei als Index für die Ausgabe des richtigen Elements aus dem Array `Wochentag` benutzt wird.

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

### Beispiel:

    <html><head><title>Test</title>
    <script language="JavaScript">
     jetzt = new Date();
     Std = jetzt.getHours();
     if(Std >= 5 && Std < 12) alert("Guten Morgen!");
     else if(Std >= 12 && Std < 18) alert("Guten Tag!");
     else if(Std >= 18 && Std <= 23) alert("Guten Abend!");
     else if(Std >= 0 && Std < 5) alert("Zeit, ins Bett zu gehen!");
    </script>
    </head><body>
    </body></html>

### Erläuterung:

Das Beispiel erzeugt ein neues Datumobjekt mit dem aktuellen Zeitpunkt in dem Objektnamen `jetzt`. Mit `jetzt.getHours()` wird die Stunde des Tages ermittelt. Der Rückgabewert des Aufrufs wird in der Variablen `Std` gespeichert. Anschließend wird ein Meldungsfenster mit einem tageszeitabhängigen Text ausgegeben, je nachdem in welchem Bereich der Wert von `Std` liegt.

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

### Beispiel:

    <html><head><title>Test</title>
    <script language="JavaScript">
     jetzt = new Date();
     Std = jetzt.getHours();
     Min = jetzt.getMinutes();
     var StdAusgabe  = ((Std < 10) ? "0" + Std : Std);
     var MinAusgabe  = ((Min < 10) ? "0" + Min : Min);
     alert("Bei Ihnen ist es jetzt " + StdAusgabe + "." + MinAusgabe + " Uhr");
    </script>
    </head><body>
    </body></html>

### Erläuterung:

Das Beispiel erzeugt ein neues Datumobjekt mit dem aktuellen Zeitpunkt in dem Objektnamen `jetzt`. Mit `jetzt.getHours()` wird die Stunde des Tages ermittelt, mit `jetzt.getMinutes()` die Minutenzahl. Der Rückgabewert der Aufrufe wird in den Variablen `Std` und `Min` gespeichert. Dann wird die Stundenzahl und die Minutenzahl für die Ausgabe formatiert. Wenn die Anzahl der Stunden oder Minuten kleiner 10 ist, wird eine 0 davorgesetzt. Schließlich wird ein Meldungsfenster mit der aktuellen Uhrzeit ausgegeben.

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

### Beispiel:

    <html><head><title>Test</title>
    </head><body>
    <script language="JavaScript">
    jetzt = new Date();
    Jahresmonat = jetzt.getMonth();
    var Monat = new
    Array("Januar","Februar","M&auml;rz","April","Mai","Juni",
    "Juli","August","September","Oktober","November","Dezember");
    document.write("<table border bgcolor=#CCFFFF><tr><td><b>");
    document.write(Monat[Jahresmonat] + "</b></td></tr></table>");
    </script>
    </body></html>

### Erläuterung:

Das Beispiel erzeugt ein neues Datumobjekt mit dem aktuellen Zeitpunkt in dem Objektnamen `jetzt`. Mit `jetzt.getMonth()` wird der numerische Wert des aktuellen Monats ermittelt. Der Rückgabewert des Aufrufs wird in der Variablen `Jahresmonat` gespeichert. Es soll jedoch ein richtiger Monatssname ausgegeben werden. Deshalb wird im Beispiel ein Array-Objekt mit deutschen Monatsnamen erzeugt.
Anschließend wird mit Hilfe von `document.write()` dynamisch eine kleine Tabelle in die Datei geschrieben, in der der aktuelle Monat formatiert ausgegeben wird. Beachten Sie, daß die Variable `Jahresmonat` dabei als Index für die Ausgabe des richtigen Elements aus dem Array `Wochentag` benutzt wird. Da auch bei Arrays bei 0 zu zählen begonnen wird, wird beispielsweise "Januar" geschrieben, wenn in `Jahresmonat` der Wert 0 gespeichert ist, oder "Februar", wenn in `Jahresmonat` der 1 gespeichert ist.

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

### Beispiel:

    <html><head><title>Test</title>
    <script language="JavaScript">
    var Zaehler = 0;
    function Anzeige()
    {
     jetzt = new Date();
     Sekunden = jetzt.getSeconds();
     alert(Sekunden);
     Zaehler = Zaehler + 1;
     if(Zaehler < 3) Anzeige();
    }
    Anzeige();
    </script>
    </head><body>
    </body></html>

### Erläuterung:

Das Beispiel definiert eine Funktion `Anzeige()`. Darin wird ein neues Datumobjekt mit dem aktuellen Zeitpunkt in dem Objektnamen `jetzt` erzeugt. Mit `jetzt.getSeconds()` wird die Sekundenzahl innerhalb der aktuellen Minute der Uhrzeit ermittelt. Der Rückgabewert des Aufrufs wird in der Variablen `Sekunden` gespeichert. Dann wird die Sekundenzahl ausgegeben. Nachdem der Anwender das Meldungsfenster mit der Anzeige bestätigt hat, wird die Variable `Zaehler` um 1 erhöht. Solange diese Variable kleiner 3 ist, wird die Funktion `Anzeige()` erneut aufgerufen. Dabei werden alle Anweisungen innerhalb der Funktion wiederholt.

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

### Beispiel:

    <html><head><title>Test</title>
    <script language="JavaScript">
     jetzt = new Date();
     alert(jetzt.getTime());
    </script>
    </head><body>
    </body></html>

### Erläuterung:

Das Beispiel erzeugt ein neues Datumobjekt mit dem aktuellen Zeitpunkt in dem Objektnamen `jetzt`. Mit `alert(jetzt.getTime())` wird die aktuelle Anzahl von Millisekunden, die seit dem 1.1.1970 vergangen sind, in einem Meldungsfenster ausgegeben. Probieren Sie das ruhig mal aus, um ein Gefühl für die Größenordnung der Werte zu bekommen, die `getTime()` liefert.

## getTimezoneOffset()

Liefert den Unterschied zwischen lokaler Rechnerzeit und Greenwich Meridian Time (GMT) in Anzahl Minuten zurück. Je nach lokaler Zeitzone, die in der Systemzeit des Anwenderrechners definiert ist, ist der Rückgabewert positiv oder negativ.

### Beispiel:

    <html><head><title>Test</title>
    <script language="JavaScript">
     jetzt = new Date();
     Unterschied = jetzt.getTimezoneOffset() / 60;
     alert("Unterschied zu Greenwich: " + Unterschied + " Stunde(n)");
    </script>
    </head><body>
    </body></html>

### Erläuterung:

Das Beispiel möchte den Unterschied zwischen Greenwich-Zeit und lokaler Zeit in Stunden ausgeben. Dazu erzeugt es ein neues Datumobjekt mit dem aktuellen Zeitpunkt in dem Objektnamen `jetzt`. Dann wird die Methode `getTimezoneOffset()` für dieses Datumobjekt aufgerufen. Um keine Minutenzahlen, sondern Stundenzahlen zu erhalten, wird der Rückgabewert gleich durch 60 geteilt. Das Ergebnis wird in der Variablen Unterschied gespeichert. In einem Meldungsfenster wird das Ergebnis anschließend ausgegeben.

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

### Beispiel:

    <html><head><title>Test</title>
    </head><body>
    <script language="JavaScript">
    jetzt = new Date();
    Jahr = jetzt.getYear();
    if(Jahr < 100) Jahr+=1900;
    document.write("<table border bgcolor=#CCFFFF><tr><td><font size=7>");
    document.write(Jahr + "</font></td></tr></table>");
    </script>
    </body></html>

### Erläuterung:

Das Beispiel erzeugt ein neues Datumobjekt mit dem aktuellen Zeitpunkt in dem Objektnamen `jetzt`. Mit `jetzt.getYear()` wird das aktuelle Jahr ermittelt. Der Rückgabewert des Aufrufs wird in der Variablen `Jahr` gespeichert. Manche Browser geben die Jahreszahl noch zweistellig aus. Für diesen Fall wird die Jahreszahl um 1900 erhöht. Anschließend wird mit Hilfe von `document.write()` dynamisch eine kleine Tabelle in die Datei geschrieben, in der das aktuelle Jahr formatiert ausgegeben wird.

## parse()

Ermittelt aus einer als Parameter zu übergebenden Zeichenkette `Zeitpunkt` die Anzahl Millisekunden, die zwischen dem 1.1.1970 0:00:00, und dem übergebenen Zeitpunkt verstrichen sind. Beachten Sie, daß Sie zum Aufrufen dieser Methode kein neues Date-Objekt erzeugen müssen, sondern direkt mit `Date` arbeiten können.

### Beispiel:

    <html><head><title>Test</title>
    <script language="JavaScript">
     DreissigJahre = Date.parse("Tue, 1 Jan 2000 00:00:00 GMT");
     alert(DreissigJahre);
    </script>
    </head><body>
    </body></html>

### Erläuterung:

Das Beispiel ermittelt die Anzahl Millisekunden zwischen dem 1.1.1970 und dem 1.1.2000. Das Ergebnis wird in der Variablen `DreissigJahre` gespeichet. Zur Kontrolle wird die Zahl in einem Meldungsfenster ausgegeben.

## setDate()

Ändert den Monatstag, der in `Objektname` gespeichert ist. Der neue Monatstag ist als Parameter zu übergeben. Sinnvolle Werte zwischen 1 und 31 übergeben.

### Beispiel:

    <html><head><title>Test</title>
    <script language="JavaScript">
    Zeit = new Date("March 10, 1998 22:48:00");
    Tag = Zeit.getDate();
    alert(Tag);
    Zeit.setDate(1);
    Tag = Zeit.getDate();
    alert(Tag);
    </script>
    </head><body>
    </body></html>

### Erläuterung:

Das Beispiel erzeugt ein neues Datumobjekt `Zeit` mit einem bestimmten Zeitpunkt, der im GMT-Format angegeben wird. Zur Kontrolle ermittelt das Beispiel den aktuellen Tag im Monat aus dem definierten Zeitpunkt und gibt ihn in einem Meldungsfenster aus. Dann wird die Methode `setDate()` auf den Objektnamen `Zeit` angewendet. Im Beispiel wird der Tag des Monats auf 1 gesetzt. Anschließend wird zur Kontrolle der neue Tag im Monat ermittelt und anschließend ausgegeben.

## setHours()

Ändert die Stunden der Uhrzeit, die in `Objektname` gespeichert sind. Die Stundenzahl ist als Parameter zu übergeben. Sinnvolle Werte zwischen 0 und 23 übergeben.

### Beispiel:

    <html><head><title>Test</title>
    <script language="JavaScript">
    Zeit = new Date();
    Std = Zeit.getHours();
    alert(Std);
    Zeit.setHours(23);
    Std = Zeit.getHours();
    alert(Std);
    </script>
    </head><body>
    </body></html>

### Erläuterung:

Das Beispiel erzeugt ein neues Datumobjekt `Zeit` mit dem aktuellen Zeitpunkt. Zur Kontrolle ermittelt das Beispiel die Stundenzahl aus der Tageszeit und gibt sie in einem Meldungsfenster aus. Dann wird die Methode `setHours()` auf den Objektnamen `Zeit` angewendet. Im Beispiel wird die Stundenzahl der Uhrzeit auf 23 gesetzt. Anschließend wird zur Kontrolle der neue Stundenanteil an der Uhrzeit ermittelt und anschließend ausgegeben.

## setMinutes()

Ändert die Minuten der Uhrzeit, die in `Objektname` gespeichert sind. Die Minutenzahl ist als Parameter zu übergeben. Sinnvolle Werte zwischen 0 und 59 übergeben.

### Beispiel:

    <html><head><title>Test</title>
    <script language="JavaScript">
    function Andersrum()
    {
     Zeit = new Date();
     Min = Zeit.getMinutes();
     MinNeu = Zeit.setMinutes(60-Min);
     Min = Zeit.getMinutes();
     return(Min);
    }
    </script>
    </head><body>
    <a href="javascript:alert(Andersrum())">Test</a>
    </body></html>

### Erläuterung:

Das Beispiel enthält einen Verweis. Beim Anklicken des Verweises wird der Rückgabewert der Funktion `Andersrum()` ausgegeben, die in einem Scriptbereich im Dateikopf notiert ist. Dort wird ein neues Datumobjekt `Zeit` mit dem aktuellen Zeitpunkt erzeugt. Aus dem Zeitpunkt wird die Minutenzahl aus der Uhrzeit ermittelt. Mit der Methode `setHours()` wird die Minutenzahl innerhalb der Stunde umgekehrt. War es vorher beispielsweise 18.12 Uhr, ist es anschließend 18.48 Uhr. Der neue Minutenanteil an der Uhrzeit wird noch mal ermittelt und anschließend zurückgegeben. Eine solche Funktion könnte etwa als Teil einer rückwärts gehenden Uhr Sinn machen.

## setSeconds()

Ändert die Sekunden der Uhrzeit, die in `Objektname` gespeichert sind. Die Sekundenzahl ist als Parameter zu übergeben. Sinnvolle Werte zwischen 0 und 59 übergeben.

### Beispiel:

    <html><head><title>Test</title>
    <script language="JavaScript">
    function Uhrzeit()
    {
     Zeit = new Date();
     Std = Zeit.getHours();
     Min = Zeit.getMinutes();
     Sek = Zeit.getSeconds();
     SekNeu = Zeit.setSeconds(Math.floor(Sek / 10));
     Sek = Zeit.getSeconds();
     return(Std + "." + Min + ":" + Sek + "0");
    }
    </script>
    </head><body>
    <a href="javascript:alert(Uhrzeit())">Uhrzeit</a>
    </body></html>

### Erläuterung:

Das Beispiel enthält einen Verweis. Beim Anklicken des Verweises wird der Rückgabewert der Funktion `Uhrzeit()` ausgegeben, die in einem Scriptbereich im Dateikopf notiert ist. Das ist die aktuelle Uhrzeit, jedoch so ausgegeben, daß Sekunden immer nur in 10er-Scrhitten ausgegeben werden. Eine Ausgabe wie 18.10:37 ist also nicht möglich, die Funktion macht 18.10:30 daraus. Zu diesem Zweck wird in der Funktion ein neues Datumobjekt `Zeit` mit dem aktuellen Zeitpunkt erzeugt. Aus dem Zeitpunkt werden die Bestandteile der Uhrzeit ermittelt. Mit der Methode `setSeconds()` wird die Sekundenzahl behandelt. Durch eine kleine mathematische Operation wird aus der möglichen Sekundenzahl zwischen 0 und 59 eine Zahl zwischen 0 und 5. Der neue Sekundenanteil an der Uhrzeit wird noch mal ermittelt. Beim Zurückgeben der Uhrzeit wird an die einstellige Sekundenzahl eine 0 angehängt, denn "in Wirklichkeit" stellt die einstellige Zahl ja den Zehneranteil an den Sekunden dar.

## setTime()

Ändert den kompetten Inhalt von `Objektname` auf einmal, erlaubt also das Setzen eines beliebigen neuen Zeitpunkts in `Objektname`. Erwartet als Parameter eine Zahl, die den neuen Zeitpunkt markiert. Die Zahl wird als Anzahl Millisekunden seit dem 1.1.1970 0:00:00 interpretiert.

### Beispiel:

    <html><head><title>Test</title>
    <script language="JavaScript">
     Zeit = new Date();
     AbsolutJetzt = Zeit.getTime();
     AbsolutDann = AbsolutJetzt + (100*24*60*60*1000);
     Zeit.setTime(AbsolutDann);
     Jahr = Zeit.getYear();
     Monat = Zeit.getMonth() + 1;
     Tag = Zeit.getDate();
     alert("in 100 Tagen ist der " + Tag + "." + Monat + "." + Jahr);
    </script>
    </head><body>
    </body></html>

### Erläuterung:

Das Beispiel gibt aus, welches Datum von jetzt ab in 100 Tagen aktuell sein wird. Zu diesem Zweck wird ein neues Datumobjekt `Zeit` mit dem aktuellen Zeitpunkt erzeugt. Mit `getTime()` wird zunächst die absolute Anzahl Millisekunden seit dem 1.1.1970 für den aktuellen Zeitpunkt ermittelt und in der Variablen `AbsolutJetzt` gespeichert. Anschließend wird zu dieser gespeicherten Zahl das Produkt aus 100*24*60*60*1000 hinzuadiert. Das ist die Anzahl Millisekunden für 100 Tage. Das Ergebnis wird in der Variablen `AbsolutDann` gespeichert. Dieser Wert wird der Methode `setTime()` übergeben. Dadurch wird die Zeit auf einen Zeitpunkt in 100 Tagen gesetzt. Mit Hilfe entsprechender Befehle werden dann aus dem neu gesetzten Zeitpunkt die Werte für den Monatstag, den Monat und das Jahr ermittelt. Das Ergebnis wird in einem Meldungsfenster ausgegeben.

## setYear()

Ändert das Jahr, das in `Objektname` gespeichert ist. Die Jahreszahl ist als Parameter zu übergeben.

### Beispiel:

    <html><head><title>Test</title>
    <script language="JavaScript">
     Zeit = new Date();
     AbsolutJetzt = Zeit.getTime();
     Jahr = Zeit.getYear();
     Zeit.setYear(Jahr+1);
     AbsolutDann = Zeit.getTime();
     Differenz = AbsolutDann - AbsolutJetzt;
     alert("bis zur gleichen Zeit in einem Jahr sind es " + Differenz + "ms");
    </script>
    </head><body>
    </body></html>

### Erläuterung:

Das Beispiel gibt die Anzahl der Millisekunden vom aktuellen Zeitpunkt bis zum gleichen Zeitpunkt in einem Jahr aus. Zu diesem Zweck wird ein neues Datumobjekt `Zeit` mit dem aktuellen Zeitpunkt erzeugt. Der Absolutzeitpunkt in Millisekunden wird mit `getTime()` ermittelt und in der Variablen `AbsolutJetzt` gespeichert. Mit `getYear()` wird das aktuelle Jahr ermittelt. Dann wird der Zeitpunkt mit `setYear()` um ein Jahr in die Zukunft verschoben. Der neue Zeitpunkt in Millisekunden wird wieder mit `getTime()` ermittelt. Das Ergebnis wird in der Variablen `AbsolutDann` gespeichert. Durch die Differenz zwischen den gespeicherten Werten von `AbsolutDann` und `AbsolutJetzt` wird die Anzahl der Millisekunden bis zum gleichen Zeitpunkt in einem Jahr ermittelt. Das Ergebnis wird in einem Meldungsfenster ausgegeben.

## 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".

### Beispiel:

    <html><head><title>Test</title>
    <script language="JavaScript">
     Jetzt = new Date();
     alert(Jetzt.toGMTString());
    </script>
    </head><body>
    </body></html>

### Erläuterung:

Das Beispiel erzeugt ein neues Datumobjekt `Jetzt` mit dem aktuellen Zeitpunkt. Dann gibt es das Ergebnis der Methode `Jetzt.toGMTString()` als Meldungsfenster aus. Beispiel einer Ausgabe:
`Wed, 11 Mar 1998 18:17:28 GMT` (Netscape)
`Wed, 11 Mar 1998 18:17:28 UTC` (MS Internet Explorer)

## 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".

### Beispiel:

    <html><head><title>Test</title>
    <script language="JavaScript">
     Jetzt = new Date();
     alert(Jetzt.toLocaleString());
    </script>
    </head><body>
    </body></html>

### Erläuterung:

Das Beispiel erzeugt ein neues Datumobjekt `Jetzt` mit dem aktuellen Zeitpunkt. Dann gibt es das Ergebnis der Methode `Jetzt.toLocaleString()` als Meldungsfenster aus. Beispiel einer Ausgabe:
`03/11/1998 19:21:22`

## UTC()

Liefert die Anzahl Millisekunden zurück, die zwischen dem 1.1.1970 und einem gewünschten Zeitpunkt verstrichen sind. Der Zeitpunkt ist in Form von Parametern zu übergeben. Alle Parameter sind als Zahlenwerte zu übergeben. Die Angabe der Datumswerte ist zwingend, die der Uhrzeitwerte optional. Die Parameter im einzelnen:
1. Jahr = Jahreszahl.
2. Monat = Monatszahl zwischen 0 und 11.
3. Tag = Tageszahl zwischen 1 und 31.
4. Stunden = (optional) Stunde der Uhrzeit zwischen 0 und 23.
5. Minuten = (optional) Minuten der Uhrzeit zwischen 0 und 59.
6. Sekunden = (optional) Sekunden der Uhrzeit zwischen 0 und 59.

### Beispiel:

    <html><head><title>Test</title>
    </head><body>
    <script language="JavaScript">
     document.write(Date.UTC(1998,2,11,19,26,00));
    </script>
    </body></html>

### Erläuterung:

Das Beispiel schreibt mit `document.write()` die Anzahl der Millisekunden in die Datei, die zwischen dem 1.1.1970, 0.00 Uhr, und dem 11.3.1998, 19.26 Uhr vergangen sind.

weiter: | Function
zurück: | Boolean

SELFHTML/Quickbar JavaScript Objekt-Referenz

© 1998 Stefan Münz, muenz@csi.com