SELFHTML/Navigationshilfen JavaScript/DOM Objekt-Referenz| SELFHTML/Navigationshilfen JavaScript/DOM Objekt-Referenz |
 |
Date |
|
Methoden:
|
 | |
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.
Objektname = new Date(); |
Objektname = new Date("Monat Tag, Jahr Stunden:Minuten:Sekunden"); |
Objektname = new Date(Jahr,Monat,Tag); |
Objektname = new Date(Jahr,Monat,Tag,Stunden,Minuten,Sekunden); |
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 9 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. Dies ist auch der Grund, warum für den Monat Oktober nicht 10 sondern 9 übergeben wird.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title>
<script type="text/javascript">
<!--
function bis2020() {
var jetzt = new Date();
var Zeit = jetzt.getTime() / 1000;
var Jahr2020 = new Date(2020,0,1,0,0,0);
var Endzeit = Jahr2020.getTime() / 1000;
var Rest = Math.floor(Endzeit - Zeit);
alert("Noch " + Rest + " Sekunden bis zum Jahr 2020");
}
//-->
</script>
</head><body>
<a href="javascript:bis2020()">Wie lange noch?</a>
</body></html>
|
Das Beispiel zeigt eine vollständige JavaScript-
Funktion. Die Funktion ermittelt die Anzahl Sekunden zwischen aktuellem Zeitpunkt und dem Jahr 2020. Dazu wird in jetzt eine neue Instanz von Date mit der aktuellen Zeit erzeugt. Für den Zeitpunkt, an dem das Jahr 2020 beginnt, wird eine zweite Objektinstanz von Date erzeugt, nämlich in Jahr2020. Dazu werden der Objektfunktion Date() entprechende Parameter übergeben. Über die beiden Objektnamen jetzt bzw. Jahr2020 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.2020. Die Differenz der beiden Werte wird in der Variablen Rest gespeichert und mit alert() in einem Meldungsfenster am Bildschirm ausgegeben.
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.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title>
</head><body>
<script type="text/javascript">
<!--
var jetzt = new Date();
var Tag = jetzt.getDate();
document.write('<table border bgcolor="#CCFFFF"><tr><td><font size="7">');
document.write(Tag + "<\/font><\/td><\/tr><\/table>");
//-->
</script>
</body></html>
|
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. Damit ein Maskieren der " entfällt, wurde als Textbegrenzerzeichen das ' gewählt.
|
|
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.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title>
</head><body>
<script type="text/javascript">
<!--
var jetzt = new Date();
var 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>
|
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, dass die Variable TagInWoche dabei als Index für die Ausgabe des richtigen Elements aus dem Array Wochentag benutzt wird.
|
|
getFullYear()Liefert im Gegensatz zu getYear() beim Netscape-Browser das volle Jahr zurück. Beim Internet Explorer liefern beide Methoden den gleichen Wert.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title>
</head><body>
<script type="text/javascript">
<!--
var jetzt = new Date();
var Jahr = jetzt.getFullYear();
document.write("Wir befinden uns im Jahr " + Jahr);
//-->
</script>
</body></html>
|
Das Beispiel erzeugt ein neues Datumobjekt mit dem aktuellen Zeitpunkt in dem Objektnamen jetzt. Mit jetzt.getFullYear() wird das volle aktuelle Jahr ermittelt. Der Rückgabewert des Aufrufs wird in der Variablen Jahr gespeichert. Anschließend wird zur Kontrolle ein Text mit der Ausgabe dieser Variablen ins Dokumentfenster geschrieben.
|
|
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.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title>
<script type="text/javascript">
<!--
var jetzt = new Date();
var 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>
|
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.
|
|
getMilliseconds()Ermittelt die Anzahl der Millisekunden seit der letzten vollen Sekunde.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title>
<script type="text/javascript">
<!--
function aktualisieren() {
var zeit = new Date();
var ms = zeit.getMilliseconds();
document.Formular.Ausgabe.value = ms;
}
//-->
</script>
</head><body onLoad="document.Formular.Ausgabe.value='0'">
<form name="Formular" action="">
<input name="Ausgabe" type="text">
<input type="button" value="aktualisieren" onClick="aktualisieren()">
</form>
</body></html>
|
Das Beispiel enthält ein Formular mit einem Eingabefeld und einem Klickbutton. Beim Anklicken des Buttons wird die Funktion aktualisieren() aufgerufen, die im Dateikopf notiert ist. Diese Funktion erzeugt ein neues Datumobjekt mit dem aktuellen Zeitpunkt in dem Objektnamen zeit. Mit zeit.getMilliseconds() werden die Millisekunden seit der letzten vollen Sekunde ermittelt. Der Rückgabewert des Aufrufs wird in der Variablen ms gespeichert. Anschließend wird der Wert des Formulareingabefeldes mit dem ermittelten Wert belegt, um das Ergebnis anzuzeigen.
|
|
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.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title>
<script type="text/javascript">
<!--
var jetzt = new Date();
var Std = jetzt.getHours();
var 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>
|
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, dass die Monatszählung bei 0 beginnt. 0 ist also Januar, 1 ist Februar usw.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title>
</head><body>
<script type="text/javascript">
<!--
var jetzt = new Date();
var Jahresmonat = jetzt.getMonth();
var Monat = new
Array("Januar","Februar","Mä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>
|
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 Monatsname 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, dass die Variable Jahresmonat dabei als Index für die Ausgabe des richtigen Elements aus dem Array Monat 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.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title>
<script type="text/javascript">
<!--
var Zaehler = 0;
function Anzeige() {
var jetzt = new Date();
var Sekunden = jetzt.getSeconds();
alert(Sekunden);
Zaehler = Zaehler + 1;
if(Zaehler < 3) Anzeige();
}
Anzeige();
//-->
</script>
</head><body>
</body></html>
|
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.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title> <script type="text/javascript"> <!-- var jetzt = new Date(); alert(jetzt.getTime()); //--> </script> </head><body> </body></html> |
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.
<html><head><title>Test</title>
<script type="text/javascript">
<!--
var jetzt = new Date();
var Unterschied = jetzt.getTimezoneOffset() / 60;
alert("Unterschied zu Greenwich: " + Unterschied + " Stunde(n)");
//-->
</script>
</head><body>
</body></html>
|
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.
Die Sommerzeit wird von dieser Methode nicht berücksichtigt.
|
|
getUTCDate()Diese Methode ist funktional identisch mit getDate(), liefert ihren Wert jedoch nicht für die lokale Zeit, sondern für die Universal Coordinated Time (UTC), auch Greenwich Mean Time (GMT) genannt.
|
|
getUTCDay()Diese Methode ist funktional identisch mit getDay(), liefert ihren Wert jedoch nicht für die lokale Zeit, sondern für die Universal Coordinated Time (UTC), auch Greenwich Mean Time (GMT) genannt.
|
|
getUTCFullYear()Diese Methode ist funktional identisch mit getFullYear(), liefert ihren Wert jedoch nicht für die lokale Zeit, sondern für die Universal Coordinated Time (UTC), auch Greenwich Mean Time (GMT) genannt.
|
|
getUTCHours()Diese Methode ist funktional identisch mit getHours(), liefert ihren Wert jedoch nicht für die lokale Zeit, sondern für die Universal Coordinated Time (UTC), auch Greenwich Mean Time (GMT) genannt.
|
|
getUTCMilliseconds()Diese Methode ist funktional identisch mit getMilliseconds(), liefert ihren Wert jedoch nicht für die lokale Zeit, sondern für die Universal Coordinated Time (UTC), auch Greenwich Mean Time (GMT) genannt.
|
|
getUTCMinutes()Diese Methode ist funktional identisch mit getMinutes(), liefert ihren Wert jedoch nicht für die lokale Zeit, sondern für die Universal Coordinated Time (UTC), auch Greenwich Mean Time (GMT) genannt.
|
|
getUTCMonth()Diese Methode ist funktional identisch mit getMonth(), liefert ihren Wert jedoch nicht für die lokale Zeit, sondern für die Universal Coordinated Time (UTC), auch Greenwich Mean Time (GMT) genannt.
|
|
getUTCSeconds()Diese Methode ist funktional identisch mit getSeconds(), liefert ihren Wert jedoch nicht für die lokale Zeit, sondern für die Universal Coordinated Time (UTC), auch Greenwich Mean Time (GMT) genannt.
|
|
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.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title>
</head><body>
<script type="text/javascript">
<!--
var jetzt = new Date();
var Jahr = jetzt.getYear();
if(Jahr < 999) Jahr+=1900;
document.write("<h1>" + Jahr + "<\/h1>");
//-->
</script>
</body></html>
|
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 Zeile 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, dass Sie zum Aufrufen dieser Methode kein neues Date-Objekt erzeugen müssen, sondern direkt mit Date arbeiten können.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title>
<script type="text/javascript">
<!--
var DreissigJahre = Date.parse("Tue, 1 Jan 2000 00:00:00 GMT");
alert(DreissigJahre);
//-->
</script>
</head><body>
</body></html>
|
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. Achten Sie darauf, dass Sie sinnvolle Werte zwischen 1 und 31 übergeben.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title>
<script type="text/javascript">
<!--
var Zeit = new Date("March 10, 1998 22:48:00");
var Tag = Zeit.getDate();
alert(Tag);
Zeit.setDate(1);
Tag = Zeit.getDate();
alert(Tag);
//-->
</script>
</head><body>
</body></html>
|
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.
|
|
setFullYear()Ändert die Jahreszahl, die in Objektname gespeichert ist. Das neue Jahr ist als Parameter zu übergeben.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title>
</head><body>
<script type="text/javascript">
<!--
var zeit = new Date();
var zukunft = zeit.setFullYear(2037);
document.write("irgendwann schreiben wir das Jahr " + zeit.getUTCFullYear());
//-->
</script>
</body></html>
|
Das Beispiel erzeugt ein neues Datumobjekt 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.
|
|
setHours()Ändert die Stunden der Uhrzeit, die in Objektname gespeichert sind. Die Stundenzahl ist als Parameter zu übergeben. Achten Sie darauf, dass Sie sinnvolle Werte zwischen 0 und 23 übergeben.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title> <script type="text/javascript"> <!-- var Zeit = new Date(); var Std = Zeit.getHours(); alert(Std); Zeit.setHours(23); Std = Zeit.getHours(); alert(Std); //--> </script> </head><body> </body></html> |
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.
|
|
setMilliseconds()Ändert die Millisekunden des Zeitpunkts, der in Objektname gespeichert ist. Die Millisekundenzahl ist als Parameter zu übergeben. Achten Sie darauf, dass Sie sinnvolle Werte zwischen 0 und 999 übergeben.
<html><head><title>Test</title>
<script type="text/javascript">
<!--
function set0() {
zeit = new Date();
zeit.setMilliseconds(0);
}
function getNow() {
zeit = new Date();
alert(zeit.getMilliseconds() + " ms sind zwischen den Klicks vergangen");
}
//-->
</script>
</head><body>
<p>Klicken Sie auf den ersten Verweis und dann ganz schnell auf den zweiten!</p>
<p><a href="javascript:set0()">erster</a>
<a href="javascript:getNow()">zweiter</a></p>
</body></html>
|
Das Beispiel enthält zwei Verweise. Der Anwender soll zunächst den ersten anklicken und dann innerhalb einer Sekunde den zweiten. Beide Verweise rufen jeweils eine Funktion auf, die im Dateikopf notiert ist. Der erste Verweis ruft set0() auf. Darin wird ein neues Datumobjekt zeit mit dem aktuellen Zeitpunkt erzeugt. Anschließend wird mit zeit.setMilliseconds(0) die Anzahl der Millisekunden auf 0 gesetzt. Die Funktion getNow(), die der andere Verweis aufruft, erzeugt ebenfalls ein Datumobjekt mit dem aktuellen Zeitpunkt, gibt dann aber mit zeit.getMilliseconds() die verstrichenen Millisekunden seit dem Setzen auf 0 aus.
|
|
setMinutes()Ändert die Minuten der Uhrzeit, die in Objektname gespeichert sind. Die Minutenzahl ist als Parameter zu übergeben. Achten Sie darauf, dass Sie sinnvolle Werte zwischen 0 und 59 übergeben.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title>
<script type="text/javascript">
<!--
function Andersrum() {
var Zeit = new Date();
var Min = Zeit.getMinutes();
var MinNeu = Zeit.setMinutes(60-Min);
var Min = Zeit.getMinutes();
return(Min);
}
//-->
</script>
</head><body>
<a href="javascript:alert(Andersrum())">Test</a>
</body></html>
|
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 setMinutes() 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.
|
|
setMonth()Ändert den Monat, der in Objektname gespeichert ist. Der gewünschte Wert ist als Parameter zu übergeben. Achten Sie darauf, dass Sie sinnvolle Werte zwischen 0 und 11 übergeben.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title>
<script type="text/javascript">
<!--
function andererMonat() {
var Zeit = new Date();
var Tag = Zeit.getDate();
Zeit.setMonth(Math.round(Math.random() * 11));
var Monat = Zeit.getMonth();
return(Tag + "." + (Monat+1) + ".");
}
//-->
</script>
</head><body>
<a href="javascript:alert(andererMonat())">Test</a>
</body></html>
|
Das Beispiel enthält einen Verweis. Beim Anklicken des Verweises wird der Rückgabewert der Funktion andererMonat() ausgegeben, die in einem Scriptbereich im Dateikopf notiert ist. Dort wird ein neues Datumobjekt Zeit mit dem aktuellen Zeitpunkt erzeugt. Mit der Methode setMonth() wird ein neuer Monat gesetzt - und zwar per Zufall. Dazu wird mit Hilfe von Math.round() und Math.random() eine zufällige Ganzzahl zwischen 0 und 11 ermittelt. Diese Zahl wird der setMonth()-Methode als Parameter übergeben. Der neue Monatszahl wird noch mal ermittelt und anschließend so formatiert zurückgegeben, dass ein sinnvolles Tagesdatum angezeigt wird.
|
|
setSeconds()Ändert die Sekunden der Uhrzeit, die in Objektname gespeichert sind. Die Sekundenzahl ist als Parameter zu übergeben. Achten Sie darauf, dass Sie sinnvolle Werte zwischen 0 und 59 übergeben.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title>
<script type="text/javascript">
<!--
function Uhrzeit() {
var Zeit = new Date();
var Std = Zeit.getHours();
var Min = Zeit.getMinutes();
var Sek = Zeit.getSeconds();
var 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>
|
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, dass 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.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title>
<script type="text/javascript">
<!--
var Zeit = new Date();
var AbsolutJetzt = Zeit.getTime();
var AbsolutDann = AbsolutJetzt + (100*24*60*60*1000);
Zeit.setTime(AbsolutDann);
var Jahr = Zeit.getYear();
var Monat = Zeit.getMonth() + 1;
var Tag = Zeit.getDate();
alert("in 100 Tagen ist der " + Tag + "." + Monat + "." + Jahr);
//-->
</script>
</head><body>
</body></html>
|
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 hinzu addiert. 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.
|
|
setUTCDate()Diese Methode ist funktional identisch mit setDate(). Der gesetzte Wert bedeutet jedoch nicht die lokale Zeit, sondern die Universal Coordinated Time (UTC), auch Greenwich Mean Time (GMT) genannt.
|
|
setUTCDay()Diese Methode ist funktional identisch mit setDay(). Der gesetzte Wert bedeutet jedoch nicht die lokale Zeit, sondern die Universal Coordinated Time (UTC), auch Greenwich Mean Time (GMT) genannt.
|
|
setUTCFullYear()Diese Methode ist funktional identisch mit setFullYear(). Der gesetzte Wert bedeutet jedoch nicht die lokale Zeit, sondern die Universal Coordinated Time (UTC), auch Greenwich Mean Time (GMT) genannt.
|
|
setUTCHours()Diese Methode ist funktional identisch mit setHours(). Der gesetzte Wert bedeutet jedoch nicht die lokale Zeit, sondern die Universal Coordinated Time (UTC), auch Greenwich Mean Time (GMT) genannt.
|
|
setUTCMilliseconds()Diese Methode ist funktional identisch mit setMilliseconds(). Der gesetzte Wert bedeutet jedoch nicht die lokale Zeit, sondern die Universal Coordinated Time (UTC), auch Greenwich Mean Time (GMT) genannt.
|
|
setUTCMinutes()Diese Methode ist funktional identisch mit setMinutes(). Der gesetzte Wert bedeutet jedoch nicht die lokale Zeit, sondern die Universal Coordinated Time (UTC), auch Greenwich Mean Time (GMT) genannt.
|
|
setUTCMonth()Diese Methode ist funktional identisch mit setMonth(). Der gesetzte Wert bedeutet jedoch nicht die lokale Zeit, sondern die Universal Coordinated Time (UTC), auch Greenwich Mean Time (GMT) genannt.
|
|
setUTCSeconds()Diese Methode ist funktional identisch mit setSeconds(). Der gesetzte Wert bedeutet jedoch nicht die lokale Zeit, sondern die Universal Coordinated Time (UTC), auch Greenwich Mean Time (GMT) genannt.
|
|
setYear()Ändert das Jahr, das in Objektname gespeichert ist. Die Jahreszahl ist als Parameter zu übergeben.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title>
<script type="text/javascript">
<!--
var Zeit = new Date();
var AbsolutJetzt = Zeit.getTime();
var Jahr = Zeit.getYear();
Zeit.setYear(Jahr+1);
var AbsolutDann = Zeit.getTime();
var Differenz = AbsolutDann - AbsolutJetzt;
alert("bis zur gleichen Zeit in einem Jahr sind es " + Differenz + "ms");
//-->
</script>
</head><body>
</body></html>
|
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", sofern sich der Benutzer in der entsprechenden Zeitzone befindet. Andernfalls wird die Zeitzonenverschiebung berücksichtigt.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title> <script type="text/javascript"> <!-- var Jetzt = new Date(); alert(Jetzt.toGMTString()); //--> </script> </head><body> </body></html> |
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)
Die Sommerzeit wird von dieser Methode nicht berücksichtigt.
|
|
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".
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title> <script type="text/javascript"> <!-- var Jetzt = new Date(); alert(Jetzt.toLocaleString()); //--> </script> </head><body> </body></html> |
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.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title> </head><body> <script type="text/javascript"> <!-- document.write(Date.UTC(1998,2,11,19,26,00)); //--> </script> </body></html> |
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.
|
| |
 |
Function
|
 |
Boolean
|
| SELFHTML/Navigationshilfen JavaScript/DOM Objekt-Referenz |
© 2001 
selfhtml@teamone.de