Kronos-heureka-code 1.0.1.1

#Kronos – Datums- und Uhrzeitangaben

---

##Exceptions

• KronosException → abgeleitet von Exception. Basisklasse aller Exceptions des Kronosprojekts

###Exceptionhierarchie

• KronosException
  • ZeitException
    • DatumException
      • JahrException
        • JahrKeineGanzeZahl
      • MonatsException
        • KeineGueltigeMonatsposition
        • KeinGueltigerMonatscode
        • KeineGueltigeTageszahl
        • KeinGueltigerMonatsname
      • TagException
        • TagKeineGanzeZahl
        • TagKleinerAlsEins
        • TagZuGross
      • WochentagException
        • UngueltigerWochentagname
        • UngueltigeWochentagposition
    • UhrzeitException
      • StundeException
        • StundeKeineGanzeZahl
        • StundeZuGross
        • StundeZuKlein
      • MinuteException
        • MinuteKeineGanzeZahl
        • MinuteZuGross
        • MinuteZuKlein
      • SekundeException
        • SekundeKeineGanzeZahl
        • SekundeZuGross
        • SekundeZuKlein

---

##Notationen

###Exceptions

###Datum

Die Datumsnotationen werden unterteilt in:

• DatumsNotationNonSplitted → Die Datumsnotationen ohne Trennzeichen bezeichnet

  • TTMMJJJJ → Tag (2 Stellen) Monat (2 Stellen) Jahr (4 Stellen)
    • TTMMJJJJ_NON_SPLITTED
  • JJJJMMTT
    • JJJJMMTT_NON_SPLITTED → Jahr (4 Stellen) Monat (2 Stellen) Tag (2 Stellen)

• DatumsNotationSplitted → Die Datumsnotationen mit Trennzeichen bezeichnet

  • TMJ → Datumsnotations-Unterklasse für eine Folge von Tag [Trennzeichen] Monat [Trennzeichen] Jahr

    Instanz	Trenner
    TMJ_DOT	Punkt (.)
    TMJ_DASH	Minus (-)
    TMJ_SLASH	Slash (/)

  • JMT → Datumsnotations-Unterklasse für eine Folge von Jahr [Trennzeichen] Monat [Trennzeichen] Tag

    Instanz	Trenner
    JMT_DOT	Punkt (.)
    JMT_DASH	Minus (-)
    JMT_SLASH	Slash (/)

Uhrzeit

Die Uhrzeitnotationen werden unterteilt in:

• UhrzeitNotationNonSplitted → Die Uhrzeitnotationen ohne Trennzeichen bezeichnet

  • HHMMSS
    • HHMMSS_NON_SPLITTED
  • SSMMHH
    • SSMMHH_NON_SPLITTED

• UhrzeitNotationSplitted → Die Uhrzeitnotationen mit Trennzeichen bezeichnet

  • HMS → Uhrzeiznotations-Unterklasse für eine Folge von Stunde [Trennzeichen] Minute [Trennzeichen] Sekunde

    Instanz	Trenner
    HMS_DOT	Punkt (.)
    HMS_DASH	Minus (-)
    HMS_SLASH	Slash (/)
    HMS_COLON	Doppelpunkt (:)

  • SMH → Uhrzeiznotations-Unterklasse für eine Folge von Sekunde [Trennzeichen] Minute [Trennzeichen] Stunde

    Instanz	Trenner
    SMH_DOT	Punkt (.)
    SMH_DASH	Minus (-)
    SMH_SLASH	Slash (/)
    SMH_COLON	Doppelpunkt (:)

---

##Datum

###Exceptions

• DatumException → abgeleitet von ZeitException

###Methoden

__init__: Nimmt, den Tag, den Monat und das Jahr als int-Werte.

__repr__: Gibt den Representations-String des Datums zurück.

ist_schaltjahr: Statische Methode, die prüft, ob ein bestimmtes Jahr ein Schaltjahr ist.

tag: Liefert den Tag des Datums.

monat: Liefert den Monat des Datums.

jahr: Liefert das Jahr des Datums.

wochentag: Property-Attribut, das den Wochentag des Datums liefert.

monatscode: Property-Attribut, das den Monatscode zur Wochentagsberechnung liefert.

jahrescode: Property-Attribut, das den Jahrescode zur Wochentagsberechnung liefert.

von_datums_notation: Errechnet ein Datum aus einem String einer gewissen Notation.

__eq__: Prüft, ob ein Datum einem anderen gleicht.

__ne__: Gibt das invertierte Ergebnis der Methode __eq__ zurück.

__lt__: Prüft, ob ein Datum kleiner oder gleich dem Argument ist.

__gt__: Prüft, ob ein Datum größer oder gleich dem Argument ist.

__le__: Prüft, ob das Datum kleiner oder gleich dem Argument ist.

__ge__: Prüft, ob das Datum größer oder gleich dem Argument ist.

###Tag

Die Klasse zum Speichern eines Tages

####Exceptions

• TagException → abgeleitet von DatumException. Basisklasse aller Exceptions, die den Tag betreffen.
• TagKeineGanzeZahl → abgeleitet von TagException. Wird ausgelöst, wenn der gegebene Tag keine ganze Zahl also ein float-Wert, oder ein nicht zur Ganzzahl konvertierbarer Typ ist, wie ein String, der nicht nur aus Zahlen besteht.
• TagKleinerAlsEins → abgeleitet von TagException. Wird ausgelöst, wenn ein gegebener Tag kleiner als 0, also unmöglich ein gültiger Tag ist.
• TagZuGross → abgeleitet von TagException. Wird ausgelöst, wenn ein gegebener Tag zu groß für einen Monat und somit ungültig ist.

####Methoden

__init__: Nimmt im Konstruktor den Tag als ganze Zahl.

tag: Property-Attribut zum Abrufen und bedingtem Setzen vom Tag.

monats_pruefung: Methode um zu prüfen, ob die Tagesanzahl für einen gegebenen Monat zu groß ist.

__repr__: Ein Representations-String für den Tag.

__str__: Liefert einen String der Tageszahl ohne zusätzlichen Text

__int__: Die Tageszahl als Integer.

__eq__: Prüft, ob der Tag gleich dem Argument ist. Hierbei wird der Integerwert des Arguments verwendet, weshalb auch ein String, eine Tag-Instanz oder ähnliches gegeben werden können.

__ne__: Prüft, ob der Tag ungleich dem Argument ist. Hierzu wird der Wert der Methode __eq__ invertiert, weshalb auch dafür passende Werte gegeben werden können.

__lt__: Prüft, ob der Wert des Tages kleiner ist, als der int-Wert des Arguments.

__gt__: Prüft, ob der Wert des Tages größer ist, als der int-Wert des Arguments.

__le__: Prüft auf Basis der Methoden __lt__ und __eq__, ob der Wert des Tages kleiner oder gleich dem int-Wert des Arguments ist.

__ge__: Prüft auf Basis der Methoden __gt__ und __eq__, ob der Wert des Tages größer oder gleich dem int-Wert des Arguments ist.

###Monat

Die Klasse zum Speichern eines Monats

####Vordefinierte Monate

Konstante	Name	Position	Monatscode	Anzahl Tage	Anzahl Tage im Schaltjahr
JANUAR	Januar	1	6	31	31
FEBRUAR	Februar	2	2	28	29
MAERZ	März	3	2	31	31
APRIL	April	4	5	30	30
MAI	Mai	5	0	31	31
JUNI	Juni	6	3	30	30
JULI	Juli	7	5	31	31
AUGUST	August	8	1	31	31
SEPTEMBER	September	9	4	30	30
OKTOBER	Oktober	10	6	31	31
NOVEMBER	November	11	2	30	30
DEZEMBER	Dezember	12	4	31	31

####Exceptions

• MonatsException → abgeleitet von DatumException. Basisklasse aller Exceptions, die den Monat betreffen.
• KeinGueltigerMonatscode → abgeleitet von MonatsException. Wird ausgelöst, wenn ein für die Wochentagsberechnung ungültiger Monatscode verwendet wurde.
• KeineGueltigeMonatsposition → abgeleitet von MonatsException. Wird ausgelöst, wenn eine ungültige Monatsposition – z.B. erster, zweiter, dritter, etc. – gegeben wird
• KeineGueltigeTageszahl → abgeleitet von MonatsException. Wird ausgelöst, wenn eine für den Monat ungüeltige Anzahl Tage gegeben wurde.
• KeinGueltigerMonatsname → abgeleitet von MonatsException. Wird ausgelöst, wenn ein ungültiger Name für einen Monat vergeben wurde.

####Methoden der Monat-Klasse

__init__: Nimmt einen Namen, eine Monatsposition, einen Monatscode, eine Anzahl Tage, die der Monat im normalen Jahr hat, eine optionale Tagesanzahl für ein eventuell abweichendes Schaltjahr.

__copy__: Liefert eine Kopie des Monats.

__repr__: Gibt einen Representations-String des Monats zurück.

__str__: Gibt den Namen des Monats zurück.

__int__: Gibt die Position des jeweiligen Monats im Jahr als Integer zurück.

name: Property-Attribut, das den Namen des Monats in einer Monatsname-Instanz liefert.

position: Property-Attribut, das die Position des Monats im Jahr in einer Monatsposition-Instanz liefert.

monatscode: Property-Attribut, das den Monatscode für die Wochentagsberechnung liefert.

anzahl_tage: Property-Attribut, das die Anzahl Tage in einem normalen Jahr in einer AnzahlTageImMonat-Instanz liefert.

anzahl_tage_im_schaltjahr: Property-Attribut, das die Anzahl Tage in einem Schaltjahr in einer AnzahlTageImMonat-Instanz liefert.

####Methoden der AnzahlTageImMonat-Klasse

__init__: Nimmt die Anzahl Tage als int-Wert.

anzahl_tage: Property-Attribut, das die Anzahl an Tagen als Integer liefert.

__int__: Liefert die Anzahl an Tagen als int-Wert.

__repr__: Liefert einen Representations-String für die Tageszahl.

__str__: Liefert die Anzahl an Tagen als String ohne zusätzliche Zeichen.

__eq__: Prüft, ob der Wert der Tageszahl dem Argument entspricht.

__ne__: Liefert den invertierten Wert der Methode __eq__.

####Methoden der Monatscode-Klasse

__init__: Nimmt den Monatscode als int-Wert oder eine Instanz der Monatscode-Klasse.

monatscode: Property-Attribut, das den Monatscode als int-Wert liefert.

__int__: Liefert den Monatscode als int-Wert.

__repr__: Liefert einen Representations-String für das Objekt.

####Methoden der Monatsname-Klasse

__init__: Nimmt den Monatsnamen als String oder eine Instanz der Klasse Monatsname.

monatsname: Property-Attribut, das den Monatsnamen liefert.

__repr__: Liefert einen Representations-String für das Objekt.

__str__: Liefert den Monatsnamen als String ohne zusätzliche Zeichen.

####Methoden der Monatsposition-Klasse

__init__: Nimmt die Position des Monats im Jahr als int-Wert oder Instanz der Monatsposition-Klasse.

position: Property-Attribut, das die Position als int-Wert liefert.

__int__: Liefert die Monatsposition als Integer.

__repr__: Liefert den Representations-String für das Objekt.

###Jahr

Die Klasse zum Speichern eines Jahres. ####Exceptions

• JahrException → abgeleitet von DatumException. Ist die Basisklasse der Exceptions, die mit dem Jahr zusammenhängen.
• JahrKeineGanzeZahl → abgeleitet von JahrException. Wird ausgelöst, wenn das gegebene Jahr keine ganze Zahl ist.

####Methoden der Jahr-Klasse

__init__: Nimmt das Jahr und die Zeitrechnung, die standardmäßig der allgemeinen Zeitrechnung entspricht.

jahr: Property-Attribut, das das Jahr als int-Wert liefert.

zeitrechnung: Property-Attribut, das die Zeitrechnung liefert.

__int__: Liefert den int-Wert des Jahres ohne Zeitrechnungsinformation.

__repr__: Liefert den Representations-String des Objekts.

###Zeitrechnung

####Vordefinierte Zeitrechnungen

Konstante	Name	Kürzel	Differenz zur allgemeinen Zeitrechnung
A_U_C	Ab urbem condita	A.u.c.	753
A_Z	Allgemeine Zeitrechnung	A.Z.	0

####Methoden __init__: Nimmt den Namen, das Kürzel und die Entfernung zur Allgemeinen Zeitrechnung.

convert: Konvertiert ein Jahr von dieser in eine andere Zeitrechnung.

delta: Property-Attribut, das die Differenz zur Allgemeinen Zeitrechnung liefert.

name: Property-Attribut, das den Namen der Zeitrechnung liefert.

kuerzel: Property-Attribut, das das Kürzel der Zeitrechnung liefert.

__repr__: Liefert den Representations-String des Objekts.

###Wochentag

Die Klasse zum Speichern eines Wochentages.

####Wochentage

#####Vordefinierte Wochentage

Konstante	Name	Position
SONNTAG	Sonntag	0
MONTAG	Montag	1
DIENSTAG	Dienstag	2
MITTWOCH	Mittwoch	3
DONNERSTAG	Donnerstag	4
FREITAG	Freitag	5
SAMSTAG	Samstag	6

#####Exceptions

• WochentagException → abgeleitet von DatumException. Basisklasse aller Exceptions, die mit dem Wochentag zusammenhängen.
• UngueltigerWochentagname → abgeleitet von WochentagException. Wird ausgelöst, wenn ein ungültiger Name für den Wochentag gegeben wurde
• UngueltigeWochentagposition → abgeleitet von WochentagException. Wird ausgelöst, wenn eine unmögliche Wochentagposition gegeben wurde.

#####Methoden der Wochentage-Klasse

get: Statische Methode, die den Wochentag einer gewissen Position zurückgibt.

__getitem__: Gibt den Wochentag einer gewissen Position zurück.

__iter__: Liefert einen Iterator, der durch die Wochentage läuft.

####Methoden der Klasse WochentageIterator

position: Property-Attribut, das die aktuelle Position des Iterators liefert.

__next__: Lässt den Iterator eins weiter zählen.

Methoden der Wochentag-Klasse

__init__: Nimmt den Namen und die Position des Wochentags

wochentag_name: Property-Attribut, das den Namen des Wochentages liefert.

wochentag_position: Property-Attribut, das die Position des Wochentages liefert.

__repr__: Liefert einen Representations-String für das Objekt zurück.

__int__: Liefert die Position des Wochentages als int-Wert.

###Methoden der WochentagName-Klasse

__init__: Nimmt den Namen des Wochentags als String.

wochentag_name: Property-Attribut, das den Namen des Wochentags liefert.

__repr__: Liefert den Representations-String des Objekts.

__str__: Liefert den Namen des Wochentags als String ohne zusätzliche Zeichen.

__eq__: Prüft, ob der Name dem String-Wert des Arguments entspricht.

__ne__: Gibt das invertierte Ergebnis der Methode __eq__ zurück.

###Methoden der WochentagPosition-Klasse

__init__: Nimt die Positon des Tages in der Woche als int-Wert.

wochentag_position: Property-Attribut, das die Position des Wochentags liefert.

__int__: Liefert die Position als int-Wert.

__repr__: Liefert den Representations-String des Objeks zurück.

__eq__: Gibt zurück, ob die Position dem int-Wert des Arguments entspricht.

__ne__: Gibt das invertierte Ergebnis der Methode __eq__ zurück.

__lt__: Prüft, ob die Position kleiner als der int-Wert des Arguments ist.

__gt__: Prüft, ob die Position größer als der int-Wert des Arguments ist.

__le__: Prüft, ob die Position kleiner oder gleich dem int-Wert des Arguments ist.

__ge__: Prüft, ob die Position größer oder gleich dem int-Wert des Arguments ist.

---

##Uhrzeit

###Exceptions

• UhrzeitException → Basisklasse für Exceptions, die mit der Uhrzeit zusammenhängen.

###Methoden

__init__: Nimmt eine Stunde, Minute und optional eine Sekunde als int-Werte.

von_uhrzeit_notation: Interpretiert einen String einer bestimmten Notation in eine Uhrzeit.

stunde: Property-Attribut, das die Stunde liefert.

minute: Property-Attribut, das die Minute liefert.

sekunde: Property-Attribut, das die Sekunde liefert.

__eq__: Gibt zurueck, ob zwei Uhrzeiten gleich sind.

__ne__: Invertiert das Ergebnis der Methode __eq__.

__lt__: Gibt zurück, ob die Uhrzeit kleiner als das Argument ist.

__gt__: Gibt zurück, ob die Uhrzeit größer als das Argument ist.

__le_: Gibt zurück, ob die Uhrzeit kleiner oder gleich dem Argument ist.

__ge__: Gibt zurück, ob die Uhrzeit größer oder gleich dem Argument ist.

__repr__: Gibt den Representations-String der Uhrzeit zurück.

###Stunde

####Exceptions

• StundeException → Basisklasse für Exceptions, die mit der Stunde zu tun haben.
• StundeKeineGanzeZahl → abgeleitet von UhrzeitException. Wird ausgelöst, wenn eine Stunde gegeben wird, die kein int-Wert ist.
• StundeZuGross → abgeleitet von StundeException. Wird ausgelöst, wenn eine Stunde, die größer ist als 59, gegeben wird.
• StundeZuKlein → abgeleitet von StundeException. Wird ausgelöst, wenn eine Stunde, die kleiner ist als 0, gegeben wird.

####Methoden

__init__: Nimmt eine Stunde als int-Wert.

stunde: Property-Attribut, das die Stunde als int-Wert liefert.

__repr__: Liefert einen Representations-String für das Objekt.

__str__: Liefert den zweistelligen Wert der Stunde als String.

__int__: Liefert die Stunde als int-Wert.

###Minute

####Exceptions

• MinuteException → abgeleitet von UhrzeitException. Basisklasse für Exceptions, die mit Minuten zusammenhängen.
• MinuteKeineGanzeZahl → abgeleitet von MinuteException. Wird geworfen, wenn eine gegebene Minute keine ganze Zahl ist.
• MinuteZuGross → abgeleitet von MinuteException. Wird geworfen, wenn eine Minute größer als 59 ist.
• MinuteZuKlein → abgeleitet von MinuteException. Wird geworfen, wenn eine Minute kleiner als 0 ist.

####Methoden

__init__: Nimmt die Minute als int-Wert.

minute: Property-Attribut, das die Minute liefert.

__repr__: Liefert den Representations-String für die Minute.

__str__: Liefert den zweistelligen String der Minute.

__int__: Liefert den Wert der Minute als Integer.

###Sekunde

####Exceptions

• SekundeExceptions → abgeleitet von UhrzeitException. Basisklasse für Exceptions, die mit einer Sekunde zusammenhängen.
• SekundeKeineGanzeZahl → abgeleitet von SekundeExceptions. Wird ausgelöst, wenn die Sekunde keine ganze Zahl ist.
• SekundeZuGross → abgeleitet von SekundeZuGross. Wird ausgelöst, wenn die Sekunde größer als 59 ist.
• SekundeZuKlein → abgeleitet von SekundeZuKlein. Wird ausgelöst, wenn die Sekunde kleiner als 0 ist.

####Methoden

__init__: Nimmt die Sekunde als Integer;

sekunde: Property-Attribut, das die Sekunde liefert.

__repr__: Liefert den Representations-String der Sekunde.

__str__: Liefert den zweistelligen String der Sekunde ohne zusätzliche Zeichen.

__int__: Liefert den Wert der Sekunde als Integer.