JavaScript - Tutorial - Objektreferenz - Date-Objekte

Date

Date stellt eine Typdefinition dar, Objekte dieses Typs müssen via new erzeugt werden.
Sie dienen dem Umgang mit Datum- und Uhrzeitangaben.

Attribute von Date-Objekten
Attribute sind in der herkömmlichen Form nicht zugänglich, alle Werte müssen über die Funktionen angesprochen werden. Stattdessen werden Date-Objekte komplett als Zahlen Interpretiert, und zwar als die seit dem 1.1.1970 00:00:00 vergangenen Millisekunden.


Funktionen von Date-Objekten
Funktion Erklärung
Erzeugung von Date-Objekten
new Date()erzeugt ein Date-Objekt mit aktuellem Datum und aktueller Uhrzeit
new Date("month d, a h:min:s")Erzeugt ein Date-Objekt aus dem übergebenen String
new Date(a,month,d)erzeugt ein Date-Objekt aus der Angabe des Jahres, Monats und Tages
new Date(a,month,d,h,min,s)erzeugt ein Date-Objekt aus den übergebenen Angaben
Abfrage von Date-Objekten
getYear()ermittelt die Jahreszahl des Objekts, die meist noch mit 1900 addiert werden muß
getMonth()ermittelt die Monatsnummer des Objekts, beginnend mit 0 für Januar
getDate()ermittelt den Tag des Monats des Objekts
getDay()ermittelt den Wochentag des Objekts, beginnend mit 0 für Sonntag
getHours()ermittelt die Stunde des Objekts
getMinutes()ermittelt die Minute des Objekts
getSeconds()ermittelt die Sekunde des Objekts
getTime()ermittelt die Differenz zum 1.1.1970 00:00:00 in Millisekunden
getTimeZoneOffset()ermittelt die Zeitzonenabweichnung vom Null-Meridian
UTC()ermittelt die GMT-Zeit als Differenz zum 1.1.1970 00:00:00 in Millisekunden
Manipulation von Date-Objekten
setYear(a)setzt die Jahreszahl des Objekts
setMonth(month)setzt die Monatsnummer des Objekts
setDate(d)setzt den Tag des Monats des Objekts
setHours(h)setzt die Stunde des Objekts
setMinutes(min)setzt die Minute des Objekts
setSeconds(s)setzt die Sekunde des Objekts
setTime()setzt die Differenz zum 1.1.1970 00:00:00 in Millisekunden
Umwandlung in Zeichenketten
toGMTString()Zeitpunkt in GMT-Format konvertieren;
toLocaleString()Zeitpunkt in lokales Zeitformat konvertieren;


Benutzung der Funktionen von Date-Objekten

var GMTString,LocaleString,GermanString;
var WeekDays=new Array("Sonntag","Montag","Dienstag","Mittwoch",
                       "Donnerstag","Freitag","Sonnabend");
var Months=new Array("Januar","Februar","März","April","Mai","Juni","Juli",
                     "August","September","Oktober","November","Dezember");

function EvaluateTime ()
{
  var ThisTime=new Date();
  var d=ThisTime.getDate();
  var month=ThisTime.getMonth();
  var a=ThisTime.getYear();
  var h=ThisTime.getHours();
  var min=ThisTime.getMinutes();
  var s=ThisTime.getSeconds();
  var hplus="",minplus="",splus="";
  GMTString=ThisTime.toGMTString();
  LocaleString=ThisTime.toLocaleString();
  GermanString=WeekDays[ThisTime.getDay()]+", ";
  if (a<1900)
    a+=1900;
  GermanString+=d+"."+Months[month]+" "+a+", ";
  if (h<10)
    hplus="0";
  if (min<10)
    minplus="0";
  if (s<10)
    splus="0";
  GermanString+=hplus+h+":"+minplus+min+":"+splus+s;
}

Diese Funktion setzt drei Strings: GMTString als Standardausgabe der GMT-Zeit, LocaleString als Standardausgabe der lokalen Zeit, GermanString als deutsche Datums- und Zeitausgabe.

Zur Erklärung der Variablen WeekDays und Months siehe auch Objektreferenz - Array-Objekte.
GMT:

locale time:

german timestring:



Ein weiteres Beispiel findet sich im Anhang C.

Autor: Ulrich Kritzner