Change Zeitraum to Zeitspanne, fix tests, change zeitspanne datetime to date and time

README.rst

@@ -96,4 +96,3 @@ Andere nennenswerte BO4E Implementierungen
 * `PHP <https://github.com/conuti-gmbh/bo4e-php/>`_ (und `Schemas <https://github.com/conuti-gmbh/bo4e-schema>`_)
 
 .. _`BO4E website`: https://www.bo4e.de/dokumentation
-.. _`Contribution Guide`: CONTRIBUTING.md

src/bo4e/__init__.py

@@ -99,7 +99,6 @@
     "VerwendungszweckProMarktrolle",
     "Zaehlwerk",
     "Zaehlzeitregister",
-    "Zeitraum",
     "Zeitreihenwert",
     "Zeitspanne",
     "Zustaendigkeit",
@@ -293,7 +292,6 @@
 from .com.verwendungszweckpromarktrolle import VerwendungszweckProMarktrolle
 from .com.zaehlwerk import Zaehlwerk
 from .com.zaehlzeitregister import Zaehlzeitregister
-from .com.zeitraum import Zeitraum
 from .com.zeitreihenwert import Zeitreihenwert
 from .com.zeitspanne import Zeitspanne
 from .com.zustaendigkeit import Zustaendigkeit

src/bo4e/bo/ausschreibung.py

@@ -15,7 +15,7 @@
 
 if TYPE_CHECKING:
     from ..com.ausschreibungslos import Ausschreibungslos
-    from ..com.zeitraum import Zeitraum
+    from ..com.zeitspanne import Zeitspanne
     from ..enum.ausschreibungsportal import Ausschreibungsportal
     from ..enum.ausschreibungsstatus import Ausschreibungsstatus
     from ..enum.ausschreibungstyp import Ausschreibungstyp
@@ -52,16 +52,14 @@ class Ausschreibung(Geschaeftsobjekt):
     Mit diesem Objekt können Geschäftspartner übertragen werden.
     Sowohl Unternehmen, als auch Privatpersonen können Geschäftspartner sein
     """
-    abgabefrist: Optional["Zeitraum"] = None
-    """
-    Diese Komponente wird zur Abbildung von Zeiträumen in Form von Dauern oder der Angabe von Start und Ende verwendet.
-    Es muss daher entweder eine Dauer oder ein Zeitraum in Form von Start und Ende angegeben sein
-    """
-    bindefrist: Optional["Zeitraum"] = None
-    """
-    Diese Komponente wird zur Abbildung von Zeiträumen in Form von Dauern oder der Angabe von Start und Ende verwendet.
-    Es muss daher entweder eine Dauer oder ein Zeitraum in Form von Start und Ende angegeben sein
-    """
+    abgabefrist: Optional["Zeitspanne"] = None
+    # """
+    # Todo: Sinnigen Docstring schreiben
+    # """
+    bindefrist: Optional["Zeitspanne"] = None
+    # """
+    # Todo: Sinnigen Docstring schreiben
+    # """
     #: Die einzelnen Lose, aus denen sich die Ausschreibung zusammensetzt
     lose: Optional[list["Ausschreibungslos"]] = None
 

src/bo4e/bo/fremdkosten.py

@@ -13,7 +13,7 @@
 if TYPE_CHECKING:
     from ..com.betrag import Betrag
     from ..com.fremdkostenblock import Fremdkostenblock
-    from ..com.zeitraum import Zeitraum
+    from ..com.zeitspanne import Zeitspanne
 
 
 # pylint: disable=too-few-public-methods
@@ -36,8 +36,8 @@ class Fremdkosten(Geschaeftsobjekt):
     """
 
     typ: Annotated[Optional["Typ"], Field(alias="_typ")] = Typ.FREMDKOSTEN
-    #: Für diesen Zeitraum wurden die Kosten ermittelt
-    gueltigkeit: Optional["Zeitraum"] = None
+    #: Für diese Zeitspanne wurden die Kosten ermittelt
+    gueltigkeit: Optional["Zeitspanne"] = None
     #: Die Gesamtsumme über alle Kostenblöcke und -positionen
     summe_kosten: Optional["Betrag"] = None
     #: In Kostenblöcken werden Kostenpositionen zusammengefasst. Beispiele: Netzkosten, Umlagen, Steuern etc

src/bo4e/bo/kosten.py

@@ -13,7 +13,7 @@
 if TYPE_CHECKING:
     from ..com.betrag import Betrag
     from ..com.kostenblock import Kostenblock
-    from ..com.zeitraum import Zeitraum
+    from ..com.zeitspanne import Zeitspanne
     from ..enum.kostenklasse import Kostenklasse
 
 
@@ -39,8 +39,8 @@ class Kosten(Geschaeftsobjekt):
     typ: Annotated[Optional["Typ"], Field(alias="_typ")] = Typ.KOSTEN
     #: Klasse der Kosten, beispielsweise Fremdkosten
     kostenklasse: Optional["Kostenklasse"] = None
-    #: Für diesen Zeitraum wurden die Kosten ermittelt
-    gueltigkeit: Optional["Zeitraum"] = None
+    #: Für diese Zeitspanne wurden die Kosten ermittelt
+    gueltigkeit: Optional["Zeitspanne"] = None
     #: In Kostenblöcken werden Kostenpositionen zusammengefasst. Beispiele: Netzkosten, Umlagen, Steuern etc
     kostenbloecke: Optional[list["Kostenblock"]] = None
 

src/bo4e/bo/preisblatt.py

@@ -15,7 +15,7 @@
 
 if TYPE_CHECKING:
     from ..com.preisposition import Preisposition
-    from ..com.zeitraum import Zeitraum
+    from ..com.zeitspanne import Zeitspanne
     from ..enum.preisstatus import Preisstatus
     from ..enum.sparte import Sparte
     from .marktteilnehmer import Marktteilnehmer
@@ -47,8 +47,8 @@ class Preisblatt(Geschaeftsobjekt):
     sparte: Optional["Sparte"] = None
     #: Merkmal, das anzeigt, ob es sich um vorläufige oder endgültige Preise handelt
     preisstatus: Optional["Preisstatus"] = None
-    #: Der Zeitraum für den der Preis festgelegt ist
-    gueltigkeit: Optional["Zeitraum"] = None
+    #: Die Zeitspanne, für die der Preis festgelegt ist
+    gueltigkeit: Optional["Zeitspanne"] = None
     #: Die einzelnen Positionen, die mit dem Preisblatt abgerechnet werden können. Z.B. Arbeitspreis, Grundpreis etc
     preispositionen: Optional[list["Preisposition"]] = None
     #: Der Netzbetreiber, der die Preise veröffentlicht hat

src/bo4e/bo/rechnung.py

@@ -16,7 +16,7 @@
     from ..com.betrag import Betrag
     from ..com.rechnungsposition import Rechnungsposition
     from ..com.steuerbetrag import Steuerbetrag
-    from ..com.zeitraum import Zeitraum
+    from ..com.zeitspanne import Zeitspanne
     from ..enum.netznutzungrechnungsart import NetznutzungRechnungsart
     from ..enum.netznutzungrechnungstyp import NetznutzungRechnungstyp
     from ..enum.rechnungsstatus import Rechnungsstatus
@@ -57,8 +57,8 @@ class Rechnung(Geschaeftsobjekt):
     faelligkeitsdatum: Optional[pydantic.AwareDatetime] = None
     #: Ein kontextbezogender Rechnungstyp, z.B. Netznutzungsrechnung
     rechnungstyp: Optional["Rechnungstyp"] = None
-    #: Der Zeitraum der zugrunde liegenden Lieferung zur Rechnung
-    rechnungsperiode: Optional["Zeitraum"] = None
+    #: Die Zeitspanne der zugrunde liegenden Lieferung zur Rechnung
+    rechnungsperiode: Optional["Zeitspanne"] = None
     #: Der Aussteller der Rechnung, die Rollencodenummer kennt man über den im Geschäftspartner verlinkten Marktteilnehmer
     rechnungsersteller: Optional["Geschaeftspartner"] = None
     #: Der Aussteller der Rechnung, die Rollencodenummer kennt man über den im Geschäftspartner verlinkten Marktteilnehmer

src/bo4e/bo/tarifinfo.py

@@ -17,7 +17,7 @@
 if TYPE_CHECKING:
     from ..com.energiemix import Energiemix
     from ..com.vertragskonditionen import Vertragskonditionen
-    from ..com.zeitraum import Zeitraum
+    from ..com.zeitspanne import Zeitspanne
     from ..enum.kundentyp import Kundentyp
     from ..enum.registeranzahl import Registeranzahl
     from ..enum.sparte import Sparte
@@ -64,8 +64,8 @@ class Tarifinfo(Geschaeftsobjekt):
     #: Freitext
     bemerkung: Optional[str] = None
 
-    #: Angabe, in welchem Zeitraum der Tarif gültig ist
-    zeitliche_gueltigkeit: Optional["Zeitraum"] = None
+    #: Angabe, in welcher Zeitspanne der Tarif gültig ist
+    zeitliche_gueltigkeit: Optional["Zeitspanne"] = None
     #: Der Energiemix, der für diesen Tarif gilt
     energiemix: Optional["Energiemix"] = None
     #: Mindestlaufzeiten und Kündigungsfristen zusammengefasst

src/bo4e/com/angebotsteil.py

@@ -13,7 +13,7 @@
     from .angebotsposition import Angebotsposition
     from .betrag import Betrag
     from .menge import Menge
-    from .zeitraum import Zeitraum
+    from .zeitspanne import Zeitspanne
 
 # pylint: disable=too-few-public-methods
 # pylint: disable=no-name-in-module
@@ -52,4 +52,4 @@ class Angebotsteil(COM):
     #: Summe der Jahresenergiekosten aller in diesem Angebotsteil enthaltenen Lieferstellen
     gesamtkostenangebotsteil: Optional["Betrag"] = None
     #: Hier kann der Belieferungszeitraum angegeben werden, für den dieser Angebotsteil gilt
-    lieferzeitraum: Optional["Zeitraum"] = None
+    lieferzeitraum: Optional["Zeitspanne"] = None

src/bo4e/com/aufabschlag.py

@@ -13,7 +13,7 @@
     from ..enum.aufabschlagsziel import AufAbschlagsziel
     from ..enum.waehrungseinheit import Waehrungseinheit
     from .preisstaffel import Preisstaffel
-    from .zeitraum import Zeitraum
+    from .zeitspanne import Zeitspanne
 
 # pylint: disable=too-few-public-methods, too-many-instance-attributes
 
@@ -49,5 +49,5 @@ class AufAbschlag(COM):
     (Nur im Falle absoluter Aufschlagstypen). """
     #: Internetseite, auf der die Informationen zum Auf-/Abschlag veröffentlicht sind.
     website: Optional[str] = None
-    #: Internetseite, auf der die Informationen zum Auf-/Abschlag veröffentlicht sind.
-    gueltigkeitszeitraum: Optional["Zeitraum"] = None
+    #: Zeitspanne, in der die Vereinbarung gültig ist.
+    gueltigkeitszeitraum: Optional["Zeitspanne"] = None

src/bo4e/com/aufabschlagregional.py

@@ -18,7 +18,7 @@
     from .preisgarantie import Preisgarantie
     from .tarifeinschraenkung import Tarifeinschraenkung
     from .vertragskonditionen import Vertragskonditionen
-    from .zeitraum import Zeitraum
+    from .zeitspanne import Zeitspanne
 
 # pylint: disable=too-few-public-methods, too-many-instance-attributes
 # pylint: disable=no-name-in-module
@@ -64,7 +64,7 @@ class AufAbschlagRegional(COM):
     #: Durch die Anwendung des Auf/Abschlags kann eine Änderung des Tarifnamens auftreten.
     tarifnamensaenderungen: Optional[str] = None
     #: Zeitraum, in dem der Abschlag zur Anwendung kommen kann
-    gueltigkeitszeitraum: Optional["Zeitraum"] = None
+    gueltigkeitszeitraum: Optional["Zeitspanne"] = None
     energiemixaenderung: Optional["Energiemix"] = None
     """ Der Energiemix kann sich durch einen AufAbschlag ändern (z.B. zwei Cent Aufschlag für Ökostrom:
     Sollte dies der Fall sein, wird hier die neue Zusammensetzung des Energiemix angegeben."""

src/bo4e/com/ausschreibungsdetail.py

@@ -11,7 +11,7 @@
     from ..enum.zaehlertyp import Zaehlertyp
     from .adresse import Adresse
     from .menge import Menge
-    from .zeitraum import Zeitraum
+    from .zeitspanne import Zeitspanne
 
 # pylint: disable=too-few-public-methods, too-many-instance-attributes
 
@@ -40,7 +40,7 @@ class Ausschreibungsdetail(COM):
     #: Die Adresse an der die Marktlokation sich befindet
     marktlokationsadresse: Optional["Adresse"] = None
     #: Angefragter Zeitraum für die ausgeschriebene Belieferung
-    lieferzeitraum: Optional["Zeitraum"] = None
+    lieferzeitraum: Optional["Zeitspanne"] = None
 
     #: Bezeichnung des zuständigen Netzbetreibers, z.B. 'Stromnetz Hamburg GmbH'
     netzbetreiber: Optional[str] = None

src/bo4e/com/ausschreibungslos.py

@@ -16,7 +16,7 @@
     from ..enum.vertragsform import Vertragsform
     from .ausschreibungsdetail import Ausschreibungsdetail
     from .menge import Menge
-    from .zeitraum import Zeitraum
+    from .zeitspanne import Zeitspanne
 
 
 @postprocess_docstring
@@ -55,7 +55,7 @@ class Ausschreibungslos(COM):
     lieferstellen: Optional[list["Ausschreibungsdetail"]] = None
 
     #: Zeitraum, für den die in diesem Los enthaltenen Lieferstellen beliefert werden sollen
-    lieferzeitraum: Optional["Zeitraum"] = None
+    lieferzeitraum: Optional["Zeitspanne"] = None
 
     #: Bemerkung des Kunden zum Los
     bemerkung: Optional[str] = None
@@ -66,13 +66,14 @@ class Ausschreibungslos(COM):
     #: Maximalmenge Toleranzband (kWh, %)
     wunsch_maximalmenge: Optional["Menge"] = None
 
-    wiederholungsintervall: Optional["Zeitraum"] = None
+    wiederholungsintervall: Optional["Zeitspanne"] = None
     """
     In welchem Intervall die Angebotsabgabe wiederholt werden darf.
     Angabe nur gesetzt für die 2. Phase bei öffentlich-rechtlichen Ausschreibungen
     """
+    #: Was bedeutet das hier genau? Wär das dann eher eine Menge?
 
     #: Kundenwunsch zur Kündigungsfrist in der Ausschreibung
-    wunsch_kuendingungsfrist: Optional["Zeitraum"] = None
+    wunsch_kuendingungsfrist: Optional["Zeitspanne"] = None
     #: Kundenwunsch zum Zahlungsziel in der Ausschreibung
-    wunsch_zahlungsziel: Optional["Zeitraum"] = None
+    wunsch_zahlungsziel: Optional["Zeitspanne"] = None

src/bo4e/com/preisgarantie.py

@@ -10,7 +10,7 @@
 
 if TYPE_CHECKING:
     from ..enum.preisgarantietyp import Preisgarantietyp
-    from .zeitraum import Zeitraum
+    from .zeitspanne import Zeitspanne
 
 # pylint: disable=too-few-public-methods
 
@@ -31,9 +31,9 @@ class Preisgarantie(COM):
 
     #: Festlegung, auf welche Preisbestandteile die Garantie gewährt wird.
     preisgarantietyp: Optional["Preisgarantietyp"] = None
-    zeitliche_gueltigkeit: Optional["Zeitraum"] = None
-    """ Zeitraum, bis zu dem die Preisgarantie gilt, z.B. bis zu einem absolutem / fixem Datum
-    oder als Laufzeit in Monaten. """
+    zeitliche_gueltigkeit: Optional["Zeitspanne"] = None
+    """ Zeitspanne, in der die Preisgarantie gilt, z.B. bis zu einem absoluten / fixen Datum
+    oder als Laufzeit mit Startdatum und Enddatum. """
 
     # optionale attributes
     #: Freitext zur Beschreibung der Preisgarantie.

src/bo4e/com/regionaleraufabschlag.py

@@ -17,7 +17,7 @@
     from .regionalepreisstaffel import RegionalePreisstaffel
     from .tarifeinschraenkung import Tarifeinschraenkung
     from .vertragskonditionen import Vertragskonditionen
-    from .zeitraum import Zeitraum
+    from .zeitspanne import Zeitspanne
 
 # pylint: disable=too-few-public-methods, too-many-instance-attributes
 # pylint: disable=no-name-in-module
@@ -71,7 +71,7 @@ class RegionalerAufAbschlag(COM):
     tarifnamensaenderungen: Optional[str] = None
 
     #: Zeitraum, in dem der Abschlag zur Anwendung kommen kann
-    gueltigkeitszeitraum: Optional["Zeitraum"] = None
+    gueltigkeitszeitraum: Optional["Zeitspanne"] = None
 
     energiemixaenderung: Optional["Energiemix"] = None
     """

src/bo4e/com/verbrauch.py

@@ -43,9 +43,9 @@ class Verbrauch(COM):
     #: Gibt die Einheit zum jeweiligen Wert an
     einheit: Optional["Mengeneinheit"] = None
 
-    #: Inklusiver Beginn des Zeitraumes, für den der Verbrauch angegeben wird
+    #: Inklusiver Beginn der Zeitspanne, für den der Verbrauch angegeben wird
     startdatum: Optional[pydantic.AwareDatetime] = None
-    #: Exklusives Ende des Zeitraumes, für den der Verbrauch angegeben wird
+    #: Exklusives Ende der Zeitspanne, für den der Verbrauch angegeben wird
     enddatum: Optional[pydantic.AwareDatetime] = None
     #: Messwertstatus includes the plausibility of the value
     messwertstatus: Optional["Messwertstatus"] = None

src/bo4e/com/vertragskonditionen.py

@@ -11,7 +11,7 @@
 
 if TYPE_CHECKING:
 
-    from .zeitraum import Zeitraum
+    from .zeitspanne import Zeitspanne
 
 # pylint: disable=too-few-public-methods
 
@@ -35,10 +35,11 @@ class Vertragskonditionen(COM):
     #: Anzahl der vereinbarten Abschläge pro Jahr, z.B. 12
     anzahl_abschlaege: Optional[Decimal] = None
     #: Über diesen Zeitraum läuft der Vertrag
-    vertragslaufzeit: Optional["Zeitraum"] = None
+    vertragslaufzeit: Optional["Zeitspanne"] = None
     #: Innerhalb dieser Frist kann der Vertrag gekündigt werden
-    kuendigungsfrist: Optional["Zeitraum"] = None
+    kuendigungsfrist: Optional["Zeitspanne"] = None
     #: Falls der Vertrag nicht gekündigt wird, verlängert er sich automatisch um die hier angegebene Zeit
-    vertragsverlaengerung: Optional["Zeitraum"] = None
+    vertragsverlaengerung: Optional["Zeitspanne"] = None
     #: In diesen Zyklen werden Abschläge gestellt. Alternativ kann auch die Anzahl in den Konditionen angeben werden.
-    abschlagszyklus: Optional["Zeitraum"] = None
+    abschlagszyklus: Optional["Zeitspanne"] = None
+    #: Todo: auch hier passt ja Zeitspanne nicht wirklich, Zeitraum auch nicht, vielleicht Menge? tbd

src/bo4e/com/zeitreihenwert.py

@@ -21,7 +21,7 @@
 @postprocess_docstring
 class Zeitreihenwert(COM):
     """
-    Abbildung eines Zeitreihenwertes bestehend aus Zeitraum, Wert und Statusinformationen.
+    Abbildung eines Zeitreihenwertes bestehend aus Zeitspanne, Wert und Statusinformationen.
 
     .. raw:: html