datumsberechnungen

 1from datetime import datetime, timedelta
 2import locale
 3from typing import Optional
 4
 5
 6class Datumsberechnungen:
 7    """
 8    Diese Klasse enthält Methoden für Datumsarithmetik mit einem Referenzdatum als Startdatum.
 9    """
10
11    def __init__(self, referenz_datum: Optional[str] = None):
12        """
13        Initialisierer für Datumsberechnungen.
14
15        Args:
16            referenz_datum: Referenzdatum im ISO-Format (YYYY-MM-DD).
17                          Falls None, wird das aktuelle Datum verwendet.
18        """
19        if referenz_datum is None:
20            # Aktuelles Datum verwenden
21            self._heute_datetime = datetime.now()
22        else:
23            # Referenzdatum aus ISO-String parsen (str: string parse time)
24            try:
25                self._heute_datetime = datetime.strptime(referenz_datum, '%Y-%m-%d')
26            except ValueError as e:
27                raise ValueError(f"Ungültiges Datumsformat '{referenz_datum}'. Erwartet: YYYY-MM-DD") from e
28
29        # Locale auf Deutsch setzen (falls verfügbar)
30        try:
31            locale.setlocale(locale.LC_TIME, 'de_DE.UTF-8')
32        except locale.Error:
33            try:
34                locale.setlocale(locale.LC_TIME, 'German_Germany.1252')
35            except locale.Error:
36                # Fallback: Englisch verwenden
37                pass
38
39    def _formatiere_datum_mit_wochentag(self, datum: datetime) -> str:
40        """
41        Formatiert ein Datum mit dem entsprechenden deutschen Wochentag.
42
43        Args:
44            datum: Das zu formatierende Datum
45
46        Returns:
47            String im Format DD.MM.YYYY (Wochentag), z.B. "15.01.2024 (Montag)"
48        """
49        # Deutsche Wochentage
50        deutsche_wochentage = {
51            0: "Montag",
52            1: "Dienstag",
53            2: "Mittwoch",
54            3: "Donnerstag",
55            4: "Freitag",
56            5: "Samstag",
57            6: "Sonntag"
58        }
59
60        datum_str = datum.strftime("%d.%m.%Y")
61        wochentag = deutsche_wochentage[datum.weekday()]
62
63        return f"{datum_str} ({wochentag})"
64
65    def heute_plus_tage(self, anzahl_tage: int) -> str:
66        """
67        Addiert Anzahl tage auf heutiges Datum und gibt das Ergebnisdatum zurück.
68
69        Args:
70            anzahl_tage: Anzahl Tage, die auf heutiges Datum zu addieren ist;
71                        kann auch negativ sein.
72
73        Returns:
74            String mit Ergebnisdatum im Format DD.MM.YYYY (Wochentag), z.B. "15.01.2024 (Montag)".
75        """
76        ergebnis_datum = self._heute_datetime + timedelta(days=anzahl_tage)
77        return self._formatiere_datum_mit_wochentag(ergebnis_datum)
78
79    def heute_minus_tage(self, anzahl_tage: int) -> str:
80        """
81        Subtrahiert Anzahl Tage vom heutigen Datum und gibt das Ergebnisdatum zurück.
82
83        Args:
84            anzahl_tage: Anzahl Tage, die vom heutigen Datum zu subtrahieren ist;
85                        sollte positiv sein.
86
87        Returns:
88            String mit Ergebnisdatum im Format DD.MM.YYYY (Wochentag), z.B. "15.01.2024 (Montag)".
89        """
90        return self.heute_plus_tage(-anzahl_tage)