SELFHTML/Quickbar  JavaScript  Objektreferenz


Date

Diese Seite ist ein Dokument mit Informationstext

 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.

 

JavaScript 1.0Netscape2.0MS IE 3.0 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.

 

JavaScript 1.0Netscape2.0MS IE 3.0 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.

 

JavaScript 1.0Netscape2.0MS IE 3.0 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.

 

JavaScript 1.0Netscape2.0MS IE 3.0 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.

 

JavaScript 1.0Netscape2.0MS IE 3.0 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.

 

JavaScript 1.0Netscape2.0MS IE 3.0 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.

 

JavaScript 1.0Netscape2.0MS IE 3.0 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.

 

JavaScript 1.0Netscape2.0MS IE 3.0 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.

 

JavaScript 1.0Netscape2.0MS IE 3.0 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.

 

JavaScript 1.0Netscape2.0MS IE 3.0 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.

 

JavaScript 1.0Netscape2.0MS IE 3.0 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.

 

JavaScript 1.0Netscape2.0MS IE 3.0 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.

 

JavaScript 1.0Netscape2.0MS IE 3.0 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.

 

JavaScript 1.0Netscape2.0MS IE 3.0 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.

 

JavaScript 1.0Netscape2.0MS IE 3.0 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.

 

JavaScript 1.0Netscape2.0MS IE 3.0 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.

 

JavaScript 1.0Netscape2.0MS IE 3.0 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)

 

JavaScript 1.0Netscape2.0MS IE 3.0 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

 

JavaScript 1.0Netscape2.0MS IE 3.0 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

1