fix docu for zeitraum (#972)

* fix docu for zeitraum

* add examples for each property

* bring back startuhrzeit

* improve docs

---------

Co-authored-by: Annika <73470827+hf-aschloegl@users.noreply.github.com>

Author: hf-krechan

src/bo4e/com/zeitraum.py

@@ -33,12 +33,35 @@ class Zeitraum(COM):
     """
 
     startdatum: Optional[date] = None
-    """Startdatum, inklusiv"""
+    """Startdatum des betrachteten Zeitraums ist **inklusiv**.
+
+    Example:
+        '2025-01-01'
+    """
     enddatum: Optional[date] = None
-    """Enddatum, inklusiv"""
+    """Enddatum des betrachteten Zeitraums ist **inklusiv**.
+
+    Example:
+        '2025-01-01'
+    """
     startuhrzeit: Optional[time] = None
-    """Startuhrzeit, inklusiv mit Zeitzone"""
+    """Startuhrzeit mit Zeitzone. Die angegebene Uhrzeit ist im betrachteten Zeitraum **inklusiv**.
+
+    Example:
+        '18:00:00+01:00'
+    """
     enduhrzeit: Optional[time] = None
-    """Enduhrzeit, exklusiv mit Zeitzone"""
+    """Enduhrzeit mit Zeitzone. Die angegebene Uhrzeit ist im betrachteten Zeitraum **exklusiv**.
+
+    Example:
+        '19:00:00+01:00'
+    """
     dauer: Optional[str] = None
-    """Dauer in ISO 8601 , example: 'P1DT30H4S', siehe https://datatracker.ietf.org/doc/html/rfc3339 """
+    """
+    Dauer in ISO 8601 Format.
+
+    Example:
+        'P1DT30H4S'
+
+    See `RFC 3339 <https://datatracker.ietf.org/doc/html/rfc3339>`_
+    """