Class Zeitstempel

  • All Implemented Interfaces:
    Struktur, ZeitWert, Kopierbar, java.lang.Comparable<Zeitstempel>

    public class Zeitstempel
    extends java.lang.Object
    implements Struktur, java.lang.Comparable<Zeitstempel>, ZeitWert, Kopierbar
    Repräsentation des Wertes eines Zeitstempels innerhalb des Uda-Skript-Interpreters. Die INstanzen dieser Klasse implementieren die Schnittstelle Struktur um den Zugriff auf die Elemente eines Zeitstempels über Namen zu ermöglichen.
    Die folgenden Elemente können über Namen abgefragt werden:
    1. tag liefert den Tag des Monats im Bereich 1..31
    2. monat liefert den Monats im Bereich 1..12
    3. jahr liefert das Jahr als vierstellige Zahl
    4. stunde liefert die Stunde im Bereich 0..23
    5. minute liefert die Minute im Bereich 0..59
    6. sekunde liefert die Sekunde im Bereich 0..59
    7. millisekunde liefert die Millisekunden
    8. millisekunden liefert den Zeitstempel als Millisekunden seit 1.1.1970 GMT
    • Constructor Summary

      Constructors 
      Constructor Description
      Zeitstempel()
      Konstruktor, der einen Zeitstempel mit dem aktuellen Zeitpunkt erzeugt.
      Zeitstempel​(long zeitWert)
      Konstruktor zum Anlagen eines Zeitstempels aus einer in Millisekunden seit 1.1.1970 GMT übergebenen Zeit.
      Zeitstempel​(java.lang.String zeitAngabe)
      Konstruktor zum Anlegen eines Zeitstempels aus einer übergebenen Zeichenkette.
    • Method Summary

      Modifier and Type Method Description
      void add​(long value)
      verschiebt den Zeitstempel innerhalb des Objekts um die angegebene Zahl von Millisekunden.
      int compareTo​(Zeitstempel o)
      vergleicht den Zeitstempel mit dem übergebenen.
      boolean equals​(java.lang.Object obj)  
      Zeitstempel erzeugeKopie()
      die Funktion erzeugt eine Kopie des Objekts ubd liefert diese zurück.
      java.lang.Object format​(java.lang.String format)
      erzeugt eine Zeichenkette, die den Zeitstempel im übergebenen Format darstellt.
      long getMilliSekunden()
      liefert den Wert des zeitstempels als Millisekunden seit dem 1.1.1970 GMT.
      java.lang.Object getStrukturElement​(java.lang.String name)
      liefert ein über einen Namen definiertes Element aus dem Objekt.
      Gültige Elemente sind tag, monat, jahr, stunde, minute, sekunde, millisekunde, millisekunden.
      liefert das Element des Objekts, dass mit dem übergebenen Namen spezifiziert wird.
      int hashCode()  
      void setMilliSekunden​(long wert)
      setzt den Wert des Zeitstempels auf den in Millisekunden seit 1.1.1970 GMT angegebenen.
      void setStrukturElement​(java.lang.String name, java.lang.Object daten)
      setzt ein über einen Namen definiertes Element innerhalb des Zeitstempels.
      Gültige Elemente sind tag, monat, jahr, stunde, minute, sekunde, millisekunde, millisekunden.
      Die Werte werden nicht auf ihren Bereich überprüft.
      java.lang.String toString()
      gibt den Zeitstempel im Standardformat als Zeichenkette aus.
      .
      • Methods inherited from class java.lang.Object

        clone, finalize, getClass, notify, notifyAll, wait, wait, wait
    • Constructor Detail

      • Zeitstempel

        public Zeitstempel()
        Konstruktor, der einen Zeitstempel mit dem aktuellen Zeitpunkt erzeugt.
      • Zeitstempel

        public Zeitstempel​(long zeitWert)
        Konstruktor zum Anlagen eines Zeitstempels aus einer in Millisekunden seit 1.1.1970 GMT übergebenen Zeit.
        Parameters:
        zeitWert - der Wert
      • Zeitstempel

        public Zeitstempel​(java.lang.String zeitAngabe)
        Konstruktor zum Anlegen eines Zeitstempels aus einer übergebenen Zeichenkette.
        Parameters:
        zeitAngabe - die Zeitangabe als Zeichenkette in einem zulässigem Format
    • Method Detail

      • add

        public void add​(long value)
        verschiebt den Zeitstempel innerhalb des Objekts um die angegebene Zahl von Millisekunden.
        Parameters:
        value - die Zeitdifferenz
      • compareTo

        public int compareTo​(Zeitstempel o)
        vergleicht den Zeitstempel mit dem übergebenen.
        Specified by:
        compareTo in interface java.lang.Comparable<Zeitstempel>
        Parameters:
        o - der Vergleichswert
        Returns:
        das Vergleichsergebnis entsprechend der Definition in Comparable.
        See Also:
        Comparable.compareTo(java.lang.Object)
      • equals

        public boolean equals​(java.lang.Object obj)
        Overrides:
        equals in class java.lang.Object
      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class java.lang.Object
      • format

        public java.lang.Object format​(java.lang.String format)
        erzeugt eine Zeichenkette, die den Zeitstempel im übergebenen Format darstellt. Wird ein ungültiger Formatstring angegeben, erfolgt die Ausgabe im Standardformat. Folgende Platzhalter für die Definition des Formats sind erlaubt:
        1. JJJJ für die Ausgabe der vierstelligen Jahreszahl
        2. JJ für die Ausgabe der zweistelligen Jahreszahl
        3. MM für die Ausgabe des Monats
        4. TT für die Ausgabe des Tags des Monats
        5. hh für die Ausgabe der Stunde
        6. mm für die Ausgabe der Minute
        7. ss für die Ausgabe der Sekunde
        8. ttt füür die Ausgabe der Millisekunden
        Die Angabe der Elemente im Formatstring muss ind der angegebenen Form mit den angegebenen Stellenzahlen erfolgen. Als zusätzliche Zeichen sind '.', ':', '/' sowie das Leerzeichen erlaubt.
        Parameters:
        format - die Beschreibung des Formats für die Ausgabe
        Returns:
        die Zeichenkette, die den Wert des zeitstempels repräsentiert
      • getMilliSekunden

        public long getMilliSekunden()
        liefert den Wert des zeitstempels als Millisekunden seit dem 1.1.1970 GMT.
        Specified by:
        getMilliSekunden in interface ZeitWert
        Returns:
        den Wert
        See Also:
        setMilliSekunden(long)
      • getStrukturElement

        public java.lang.Object getStrukturElement​(java.lang.String name)
        liefert ein über einen Namen definiertes Element aus dem Objekt.
        Gültige Elemente sind tag, monat, jahr, stunde, minute, sekunde, millisekunde, millisekunden.
        liefert das Element des Objekts, dass mit dem übergebenen Namen spezifiziert wird.
        Specified by:
        getStrukturElement in interface Struktur
        Parameters:
        name - der Name
        Returns:
        das Objekt
        See Also:
        Struktur.getStrukturElement(java.lang.String), setStrukturElement(String, Object)
      • setMilliSekunden

        public void setMilliSekunden​(long wert)
        setzt den Wert des Zeitstempels auf den in Millisekunden seit 1.1.1970 GMT angegebenen.
        Specified by:
        setMilliSekunden in interface ZeitWert
        Parameters:
        wert - der Wert
        See Also:
        getMilliSekunden()
      • setStrukturElement

        public void setStrukturElement​(java.lang.String name,
                                       java.lang.Object daten)
        setzt ein über einen Namen definiertes Element innerhalb des Zeitstempels.
        Gültige Elemente sind tag, monat, jahr, stunde, minute, sekunde, millisekunde, millisekunden.
        Die Werte werden nicht auf ihren Bereich überprüft. Wird ein Zahlenwert übergeben, der den jeweiligen Bereich überschreitet erfolgt ein Überlauf auf das jeweilige benachbarte Element.
        setzt das Element des Objekts, dass mit dem übergebenen Namen beschrieben wird auf den übergebenen Wert..
        Specified by:
        setStrukturElement in interface Struktur
        Parameters:
        name - der Name
        daten - das Datenobjekt
        See Also:
        Struktur.setStrukturElement(java.lang.String, java.lang.Object), getStrukturElement(String)
      • toString

        public java.lang.String toString()
        gibt den Zeitstempel im Standardformat als Zeichenkette aus.
        .
        Overrides:
        toString in class java.lang.Object
        See Also:
        Object.toString()