Package de.svws_nrw.asd.validate

Klasse DateManager

java.lang.Object
de.svws_nrw.asd.validate.DateManager
Alle implementierten Schnittstellen:
Comparable<DateManager>
public final class DateManager extends Object implements Comparable<DateManager>
Dieser Manager stellt Methoden zum Umgang mit Datumswerten zur Verfügung. Die Daten werden im Input und Output jeweils im ISO 8601-Format (yyyy-mm-dd) erwartet. Für die Lesbarkeit in Textausgaben steht auch die Möglichkeit des deutschen Datumsformates zur Verfügung.

  • Methodenübersicht

    Modifizierer und Typ
    Methode
    Beschreibung
    int
    compareTo(DateManager other)
     
    boolean
    equals(Object obj)
     
    static @NotNull DateManager
    from(String isoDate)
    Erstellt einen neuen Date-Manager für das angegebene Datum im ISO-Format 8601
    static @NotNull DateManager
    fromValues(int jahr, int monat, int tag)
    Erstellt einen neuen Date-Manager für das angegebene Datum mit den angegebenen Werten.
    int
    getAlter(@NotNull DateManager other)
    Bestimmt das Alter einer Person, die am Datum dieses Managers geboren ist anhand des Datums im übergebenen Manager.
    int
    getJahr()
    Gibt das Jahr des Datums zurück.
    int
    getKalenderwoche()
    Gibt die Kalenderwoche zurück.
    int
    getKalenderwochenjahr()
    Das Kalenderwochenjahr, welches ggf. am Anfang oder Ende des Jahres vom Jahr des Datums abweichen kann.
    int
    getMaxTageImMonat()
    Gibt die maximale Anzahl der Tage im Monat zurück.
    int
    getMonat()
    Gibt den Monat des Datums zurück.
    int
    getTag()
    Gibt den Tag im Monat des Datums zurück.
    int
    getTagImJahr()
    Gibt den Tag im Jahr zurück. (1 - 365 bzw. 366 im Schaltjahr)
    int
    getWochentag()
    Gibt den Wochentag zurück (1 - Montag, 2 - Dienstag, ..., 7 - Sonntag)
    int
    hashCode()
     
    boolean
    isSchaltjahr()
    Gibt zurück, ob es sich bei dem Jahr des Datums um ein Schaltjahr handelt oder nicht.
    boolean
    istInJahren(int von, int bis)
    Prüft, ob das Datum in dem Interval [von; bis] liegt.

    Von Klasse geerbte Methoden java.lang.Object

    clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

  • Methodendetails

    • fromValues

      @NotNull public static @NotNull DateManager fromValues(int jahr, int monat, int tag) throws InvalidDateException
      Erstellt einen neuen Date-Manager für das angegebene Datum mit den angegebenen Werten.
      Parameter:
      jahr - das Jahr (z.B. 2024)
      monat - der Monat (z.B. 8 für August)
      tag - der Tag im Monat (z.B. 31)
      Gibt zurück:
      der Manager
      Löst aus:
      InvalidDateException - falls das Datum fehlerhaft ist

    • from

      @NotNull public static @NotNull DateManager from(String isoDate) throws InvalidDateException
      Erstellt einen neuen Date-Manager für das angegebene Datum im ISO-Format 8601
      Parameter:
      isoDate - Das Datum im ISO-Format
      Gibt zurück:
      der Manager
      Löst aus:
      InvalidDateException - falls das Datumsformat oder das Datum fehlerhaft ist

    • compareTo

      public int compareTo(DateManager other)
      Angegeben von:
      compareTo in Schnittstelle Comparable<DateManager>

    • hashCode

      public int hashCode()
      Setzt außer Kraft:
      hashCode in Klasse Object

    • equals

      public boolean equals(Object obj)
      Setzt außer Kraft:
      equals in Klasse Object

    • getTag

      public int getTag()
      Gibt den Tag im Monat des Datums zurück.
      Gibt zurück:
      der Tag im Monat

    • getMonat

      public int getMonat()
      Gibt den Monat des Datums zurück.
      Gibt zurück:
      der Monat

    • getJahr

      public int getJahr()
      Gibt das Jahr des Datums zurück.
      Gibt zurück:
      das Jahr

    • isSchaltjahr

      public boolean isSchaltjahr()
      Gibt zurück, ob es sich bei dem Jahr des Datums um ein Schaltjahr handelt oder nicht.
      Gibt zurück:
      true, falls ein Schaltjahr vorliegt, und ansonsten false

    • getTagImJahr

      public int getTagImJahr()
      Gibt den Tag im Jahr zurück. (1 - 365 bzw. 366 im Schaltjahr)
      Gibt zurück:
      der Tag im Jahr

    • getMaxTageImMonat

      public int getMaxTageImMonat()
      Gibt die maximale Anzahl der Tage im Monat zurück. Bei dem Februar wird berücksichtigt, ob es sich um ein Schaltjahr handelt oder nicht.
      Gibt zurück:
      28, 29, 30 oder 31

    • getWochentag

      public int getWochentag()
      Gibt den Wochentag zurück (1 - Montag, 2 - Dienstag, ..., 7 - Sonntag)
      Gibt zurück:
      der Wochentag

    • getKalenderwoche

      public int getKalenderwoche()
      Gibt die Kalenderwoche zurück. Hierbei kann am Anfang oder Ende des Jahres das Kalenderwochenjahr ggf. vom Jahr des Datums abweichen.
      Gibt zurück:
      die Kalenderwoche

    • getKalenderwochenjahr

      public int getKalenderwochenjahr()
      Das Kalenderwochenjahr, welches ggf. am Anfang oder Ende des Jahres vom Jahr des Datums abweichen kann.
      Gibt zurück:
      das Kalenderwochenjahr

    • getAlter

      public int getAlter(@NotNull @NotNull DateManager other) throws InvalidDateException
      Bestimmt das Alter einer Person, die am Datum dieses Managers geboren ist anhand des Datums im übergebenen Manager.
      Parameter:
      other - der andere Manager
      Gibt zurück:
      das Alter einer Person, die am Datum dieses Managers geboren an dem gegebenen Datum
      Löst aus:
      InvalidDateException - falls das übergebene Datum früher liegt als das Geburtsdatum des Managers

    • istInJahren

      public boolean istInJahren(int von, int bis)
      Prüft, ob das Datum in dem Interval [von; bis] liegt.
      Parameter:
      von - das erste Jahr, welches akzeptiert wird
      bis - das letzte Jahr, welches akzeptiert wird
      Gibt zurück:
      true, falls das Datum in dem Bereich liegt, und ansonsten false