API: Bundesland-Feiertage für REST API erweitert

- tage_werktage Endpunkt unterstützt jetzt bundesland Parameter - Swagger-Dokumentation aktualisiert mit bundesland Parameter - Alle 16 deutschen Bundesländer in der API-Dokumentation aufgelistet
Feat: Bundesland-Feiertage für Werktagsberechnung hinzugefügt
2025-07-25 17:13:39 +02:00 · 2025-07-25 17:10:57 +02:00
5 changed files with 128 additions and 11 deletions
--- a/README.md
+++ b/README.md
@@ -41,7 +41,7 @@ Datumsrechner Live: [https://date.elpatron.me](https://date.elpatron.me)
 ## Funktionen

 - Anzahl der Tage zwischen zwei Daten
- Anzahl der Werktage zwischen zwei Daten
+- Anzahl der Werktage zwischen zwei Daten (mit optionaler Berücksichtigung bundeslandspezifischer Feiertage)
 - Anzeige des Wochentags eines Datums
 - Datum plus/minus X Tage
 - Datum plus/minus X Werktage
@@ -50,6 +50,30 @@ Datumsrechner Live: [https://date.elpatron.me](https://date.elpatron.me)
 - Start-/Enddatum einer Kalenderwoche eines Jahres
 - Statistik-Dashboard mit Passwortschutz unter `/stats`

+## Bundesland-Feiertage
+
+Die Werktagsberechnung kann optional bundeslandspezifische Feiertage berücksichtigen. Dazu wird die kostenlose API von [feiertage-api.de](https://feiertage-api.de) verwendet.
+
+**Verfügbare Bundesländer:**
+- Baden-Württemberg (BW)
+- Bayern (BY)
+- Berlin (BE)
+- Brandenburg (BB)
+- Bremen (HB)
+- Hamburg (HH)
+- Hessen (HE)
+- Mecklenburg-Vorpommern (MV)
+- Niedersachsen (NI)
+- Nordrhein-Westfalen (NW)
+- Rheinland-Pfalz (RP)
+- Saarland (SL)
+- Sachsen (SN)
+- Sachsen-Anhalt (ST)
+- Schleswig-Holstein (SH)
+- Thüringen (TH)
+
+Die Feiertage werden automatisch für den gewählten Zeitraum abgerufen und bei der Werktagsberechnung als arbeitsfreie Tage behandelt. Im Ergebnis werden zusätzlich die Anzahl der Wochenendtage und Feiertage angezeigt.
+
 ## Installation (lokal)

 1. Python 3.8+ installieren
@@ -148,7 +172,8 @@ Alle Datumsfunktionen stehen auch als REST-API zur Verfügung. Die API akzeptier
 {
  "start": "2024-06-01",
  "end": "2024-06-10",
-  "werktage": true
+  "werktage": true,
+  "bundesland": "BY"
 }
 ```

@@ -156,7 +181,7 @@ Alle Datumsfunktionen stehen auch als REST-API zur Verfügung. Die API akzeptier
 ```bash
 curl -X POST http://localhost:5000/api/tage_werktage \
  -H "Content-Type: application/json" \
-  -d '{"start": "2024-06-01", "end": "2024-06-10", "werktage": true}'
+  -d '{"start": "2024-06-01", "end": "2024-06-10", "werktage": true, "bundesland": "BY"}'
 ```

 **Antwort:**
@@ -164,6 +189,8 @@ curl -X POST http://localhost:5000/api/tage_werktage \
 { "result": 7 }
 ```

+**Hinweis:** Der Parameter `bundesland` ist optional und wird nur bei `"werktage": true` berücksichtigt. Verfügbare Bundesland-Kürzel siehe oben.
+
 #### 2. Wochentag zu einem Datum

 **POST** `/api/wochentag`
--- a/app.py
+++ b/app.py
@@ -4,6 +4,7 @@ import numpy as np
 from dateutil.relativedelta import relativedelta
 import os
 import time
+import requests

 app_start_time = time.time()

@@ -14,6 +15,18 @@ app.secret_key = os.environ.get('SECRET_KEY', 'dev-key')

 WOCHENTAGE = ["Montag", "Dienstag", "Mittwoch", "Donnerstag", "Freitag", "Samstag", "Sonntag"]

+def get_feiertage(year, bundesland):
+    """Holt die Feiertage für ein Jahr und Bundesland von feiertage-api.de."""
+    url = f"https://feiertage-api.de/api/?jahr={year}&nur_land={bundesland}"
+    try:
+        resp = requests.get(url, timeout=5)
+        data = resp.json()
+        # Die API gibt ein Dict mit Feiertagsnamen als Key, jeweils mit 'datum' als Wert
+        return [v['datum'] for v in data.values() if 'datum' in v]
+    except Exception as e:
+        print(f"Fehler beim Abrufen der Feiertage: {e}")
+        return []
+
@app.route('/', methods=['GET', 'POST'])
 def index():
    # Rudimentäres Logging für Page Impressions
@@ -40,6 +53,7 @@ def index():
        from datetime import datetime as dt
        f.write(f"{dt.now().isoformat()} PAGEVIEW\n")
    tage = werktage = wochentag = datumsrechnung = werktagsrechnung = kw_berechnen = kw_datum = wochen_monate = None
+    feiertage_anzahl = wochenendtage_anzahl = None
    active_idx = 0
    plusminus_result = None
    if request.method == 'POST':
@@ -53,13 +67,27 @@ def index():
            start = request.form.get('start1')
            end = request.form.get('end1')
            is_werktage = request.form.get('werktage') in ('on', 'true', '1', True)
+            bundesland = request.form.get('bundesland')
            try:
                d1 = datetime.strptime(start, '%Y-%m-%d')
                d2 = datetime.strptime(end, '%Y-%m-%d')
-                if is_werktage:
                if d1 > d2:
                    d1, d2 = d2, d1
-                    tage = np.busday_count(d1.date(), (d2 + timedelta(days=1)).date())
+                # Feiertage bestimmen
+                holidays = []
+                if bundesland:
+                    years = set([d1.year, d2.year])
+                    for y in years:
+                        holidays.extend(get_feiertage(y, bundesland))
+                # Alle Tage im Bereich
+                all_days = [(d1 + timedelta(days=i)).date() for i in range((d2 - d1).days + 1)]
+                # Wochenendtage zählen
+                wochenendtage_anzahl = sum(1 for d in all_days if d.weekday() >= 5)
+                # Feiertage zählen (nur die, die im Bereich liegen und nicht auf Wochenende fallen)
+                feiertage_im_zeitraum = [f for f in holidays if d1.date() <= datetime.strptime(f, '%Y-%m-%d').date() <= d2.date()]
+                feiertage_anzahl = sum(1 for f in feiertage_im_zeitraum if datetime.strptime(f, '%Y-%m-%d').date().weekday() < 5)
+                if is_werktage:
+                    tage = np.busday_count(d1.date(), (d2 + timedelta(days=1)).date(), holidays=holidays)
                else:
                    tage = abs((d2 - d1).days)
            except Exception:
@@ -129,7 +157,9 @@ def index():
                        plusminus_result = f"Datum {d.strftime('%d.%m.%Y')} {'plus' if anzahl_int>=0 else 'minus'} {abs(anzahl_int)} Monate: {result.strftime('%d.%m.%Y')}"
            except Exception:
                plusminus_result = 'Ungültige Eingabe'
-    return render_template('index.html', tage=tage, werktage=werktage, wochentag=wochentag, plusminus_result=plusminus_result, kw_berechnen=kw_berechnen, kw_datum=kw_datum, active_idx=active_idx)
+    return render_template('index.html', tage=tage, werktage=werktage, wochentag=wochentag, plusminus_result=plusminus_result, kw_berechnen=kw_berechnen, kw_datum=kw_datum, active_idx=active_idx
+        , feiertage_anzahl=feiertage_anzahl, wochenendtage_anzahl=wochenendtage_anzahl
+    )


 def parse_log_stats(log_path):
@@ -187,13 +217,20 @@ def api_tage_werktage():
    start = data.get('start')
    end = data.get('end')
    is_werktage = data.get('werktage', False)
+    bundesland = data.get('bundesland')
    try:
        d1 = datetime.strptime(start, '%Y-%m-%d')
        d2 = datetime.strptime(end, '%Y-%m-%d')
        if is_werktage:
            if d1 > d2:
                d1, d2 = d2, d1
-            tage = int(np.busday_count(d1.date(), (d2 + timedelta(days=1)).date()))
+            holidays = []
+            if bundesland:
+                # Feiertage für alle Jahre im Bereich holen
+                years = set([d1.year, d2.year])
+                for y in years:
+                    holidays.extend(get_feiertage(y, bundesland))
+            tage = int(np.busday_count(d1.date(), (d2 + timedelta(days=1)).date(), holidays=holidays))
        else:
            tage = abs((d2 - d1).days)
        return jsonify({'result': tage})
--- a/requirements.txt
+++ b/requirements.txt
@@ -2,3 +2,4 @@ Flask==3.0.3
 numpy==1.26.4 
 python-dateutil==2.9.0.post0 
 pytest==8.2.2 
+requests 
--- a/static/swagger.json
+++ b/static/swagger.json
@@ -21,7 +21,12 @@
                "properties": {
                  "start": { "type": "string", "format": "date" },
                  "end": { "type": "string", "format": "date" },
-                  "werktage": { "type": "boolean", "default": false }
+                  "werktage": { "type": "boolean", "default": false },
+                  "bundesland": { 
+                    "type": "string", 
+                    "description": "Bundesland-Kürzel für Feiertagsberücksichtigung (nur bei werktage=true)",
+                    "enum": ["BW", "BY", "BE", "BB", "HB", "HH", "HE", "MV", "NI", "NW", "RP", "SL", "SN", "ST", "SH", "TH"]
+                  }
                },
                "required": ["start", "end"]
              }
--- a/templates/index.html
+++ b/templates/index.html
@@ -604,16 +604,49 @@ footer br + a {
                            <legend class="sr-only">Optionen</legend>
                            <input type="checkbox" name="werktage" id="werktage" {% if request.form.get('werktage') %}checked{% endif %} aria-checked="{{ 'true' if request.form.get('werktage') else 'false' }}">
                            <label for="werktage" style="margin:0;">Nur Werktage</label>
+                            <label for="bundesland" style="margin-left:1em;">Feiertage berücksichtigen für:
+                                <select name="bundesland" id="bundesland" {% if not request.form.get('werktage') %}disabled{% endif %}>
+                                    <option value="">(kein Bundesland)</option>
+                                    <option value="BW" {% if request.form.get('bundesland') == 'BW' %}selected{% endif %}>Baden-Württemberg</option>
+                                    <option value="BY" {% if request.form.get('bundesland') == 'BY' %}selected{% endif %}>Bayern</option>
+                                    <option value="BE" {% if request.form.get('bundesland') == 'BE' %}selected{% endif %}>Berlin</option>
+                                    <option value="BB" {% if request.form.get('bundesland') == 'BB' %}selected{% endif %}>Brandenburg</option>
+                                    <option value="HB" {% if request.form.get('bundesland') == 'HB' %}selected{% endif %}>Bremen</option>
+                                    <option value="HH" {% if request.form.get('bundesland') == 'HH' %}selected{% endif %}>Hamburg</option>
+                                    <option value="HE" {% if request.form.get('bundesland') == 'HE' %}selected{% endif %}>Hessen</option>
+                                    <option value="MV" {% if request.form.get('bundesland') == 'MV' %}selected{% endif %}>Mecklenburg-Vorpommern</option>
+                                    <option value="NI" {% if request.form.get('bundesland') == 'NI' %}selected{% endif %}>Niedersachsen</option>
+                                    <option value="NW" {% if request.form.get('bundesland') == 'NW' %}selected{% endif %}>Nordrhein-Westfalen</option>
+                                    <option value="RP" {% if request.form.get('bundesland') == 'RP' %}selected{% endif %}>Rheinland-Pfalz</option>
+                                    <option value="SL" {% if request.form.get('bundesland') == 'SL' %}selected{% endif %}>Saarland</option>
+                                    <option value="SN" {% if request.form.get('bundesland') == 'SN' %}selected{% endif %}>Sachsen</option>
+                                    <option value="ST" {% if request.form.get('bundesland') == 'ST' %}selected{% endif %}>Sachsen-Anhalt</option>
+                                    <option value="SH" {% if request.form.get('bundesland') == 'SH' %}selected{% endif %}>Schleswig-Holstein</option>
+                                    <option value="TH" {% if request.form.get('bundesland') == 'TH' %}selected{% endif %}>Thüringen</option>
+                                </select>
+                            </label>
                        </fieldset>
                        <button name="action" value="tage_werktage" type="submit">Berechnen</button>
                    </form>
                    {% if tage is not none %}
                        <div class="result" aria-live="polite">
                            {% if request.form.get('werktage') %}
-                                Anzahl der Werktage zwischen <b>{{ format_date(request.form.get('start1', '')) }}</b> und <b>{{ format_date(request.form.get('end1', '')) }}</b>: {{ tage }}
+                                Anzahl der Werktage zwischen <b>{{ format_date(request.form.get('start1', '')) }}</b> und <b>{{ format_date(request.form.get('end1', '')) }}</b>{% if request.form.get('bundesland') %} (Feiertage {{ request.form.get('bundesland') }}){% endif %}: {{ tage }}
                            {% else %}
                                Anzahl der Tage zwischen <b>{{ format_date(request.form.get('start1', '')) }}</b> und <b>{{ format_date(request.form.get('end1', '')) }}</b>: {{ tage }}
                            {% endif %}
+                            {% if wochenendtage_anzahl is not none or feiertage_anzahl is not none %}
+                                <br>
+                                <span style="font-size:0.98em; color:#1e293b;">
+                                    {% if wochenendtage_anzahl is not none %}
+                                        <b>{{ wochenendtage_anzahl }}</b> Wochenendtage
+                                    {% endif %}
+                                    {% if feiertage_anzahl is not none %}
+                                        {% if wochenendtage_anzahl is not none %} | {% endif %}
+                                        <b>{{ feiertage_anzahl }}</b> Feiertage (Mo-Fr{% if request.form.get('bundesland') %}, {{ request.form.get('bundesland') }}{% endif %})
+                                    {% endif %}
+                                </span>
+                            {% endif %}
                        </div>
                    {% endif %}
                </div>
@@ -788,5 +821,19 @@ footer br + a {
        <a href="/api-docs" target="_blank" style="color:#2563eb; text-decoration:underline;">REST API Dokumentation (Swagger)</a><br>
        © 2025 <a href="mailto:elpatron@mailbox.org?subject=Datumsrechner" style="color:#2563eb; text-decoration:underline;">M. Busche</a>
    </footer>
+<script>
+document.addEventListener('DOMContentLoaded', function() {
+    var werktageCheckbox = document.getElementById('werktage');
+    var bundeslandSelect = document.getElementById('bundesland');
+    if (werktageCheckbox && bundeslandSelect) {
+        function toggleBundesland() {
+            bundeslandSelect.disabled = !werktageCheckbox.checked;
+        }
+        werktageCheckbox.addEventListener('change', toggleBundesland);
+        // Initial setzen
+        toggleBundesland();
+    }
+});
+</script>
 </body>
 </html>