Bietet die Verwaltung von Daten und Uhrzeiten
Project description
#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
- JahrException
- UhrzeitException
- StundeException
- StundeKeineGanzeZahl
- StundeZuGross
- StundeZuKlein
- MinuteException
- MinuteKeineGanzeZahl
- MinuteZuGross
- MinuteZuKlein
- SekundeException
- SekundeKeineGanzeZahl
- SekundeZuGross
- SekundeZuKlein
- StundeException
- DatumException
- ZeitException
##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)
- TTMMJJJJ → Tag (2 Stellen) Monat (2 Stellen) Jahr (4 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
- HHMMSS
-
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for Kronos-heureka-code-1.0.1.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | a641a37a23d5ffa11cc874a26264c1240da4da0304c8a30953820c4c2e952e42 |
|
MD5 | 689c0c06034001919f390c118ca4d339 |
|
BLAKE2b-256 | 713ddbb83852560b9d2df5d4cfa62ce8f876395d499639c58bacdf18e38d46ed |
Hashes for Kronos_heureka_code-1.0.1.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b4f319610802e8f5addba31fe485da3a8966490dd8dd9f35fc50cdeff7a8042c |
|
MD5 | 234855a0ee12470060ec62c0c9e97d52 |
|
BLAKE2b-256 | cffe77a820eec043146b4a493129551fea6cf21cba57edb1c07bba4192fc6b62 |