10.6 Die Klasse Date 

Die ältere Klasse Date ist durch die Aufgabenverteilung auf die Klassen DateFormat und Calendar sehr schlank. Ein Exemplar der Klasse Date verwaltet ein besonderes Datum oder eine bestimmte Zeit; die Zeitgenauigkeit beträgt eine Millisekunde.

10.6.1 Objekte erzeugen und Methoden nutzen 

Viele der Methoden von Date sind veraltet, und zwei Konstruktoren der Klasse bleiben uns. Die anderen Methoden erlauben Zeitvergleiche und operieren auf den Millisekunden.

class java.util.  Date  
implements Serializable, Cloneable, Comparable

Date() Erzeugt ein Datum-Objekt und initialisiert es mit der Zeit, die bei der Erzeugung gelesen wurde. Die gegenwärtige Zeit erfragt dieser Konstruktor mittels System.currentTimeMillis().

Date( long date ) Erzeugt ein Datum-Objekt und initialisiert es mit der übergebenen Anzahl von Millisekunden seit dem 1. Januar 1970, 00:00:00 GMT.1

long getTime() Liefert die Anzahl der Millisekunden nach dem 1. Januar 1970, 00:00:00 GMT zurück.

void setTime( long time ) Setzt wie der Konstruktor die Anzahl Millisekunden des Datum-Objekts neu. Wurde ein Datum-Objekt einmal erzeugt, dann ändert sich das durch das Objekt repräsentierte Datum natürlich nicht mehr automatisch. Um also die Zeit wieder aktuell zu setzen, kann today.setTime( new java.util.Date() ) verwendet werden.

boolean before( Date when ) boolean after( Date when ) Testet, ob das eigene Datum vor oder nach dem übergebenen Datum liegt: true, wenn davor oder danach, sonst false.

boolean equals( Object obj ) Testet die Datums-Objekte auf Gleichheit. true, wenn getTime() für beide den gleichen Wert ergibt und der aktuelle Parameter nicht null ist.

int compareTo( Date anotherDate ) Vergleicht zwei Datum-Objekte und gibt null zurück, falls beide die gleiche Zeit repräsentieren. Der Rückgabewert ist kleiner null, falls das Datum des aufrufenden Exemplars vor dem Datum von anotherDate ist, sonst größer null.

int compareTo( Object o ) Ist das übergebene Objekt vom Typ Date, dann verhält sich die Funktion wie compareTo(). Andernfalls wirft die Methode eine ClassCastException. Die Methode ist eine Vorgabe aus der Schnittstelle Comparable. Mit der Funktion lassen sich Date-Objekte in einem Feld über Arrays.sort(Object[]) einfach sortieren.

String toString() Gibt eine Repräsentation des Datums aus.

Listing 10.6   MiniClock.java

class MiniClock
{
  public static void main( String args[] )
  {
    System.out.println( new java.util.Date() );
  }
}

¹  Bei Visual Basic steht der Wert 0 für den 30.12.1899. Super Idee! Excel beginnt einen Tag später, beim 1.1.1900.