KARL Business Days

KARL is an offline calculator for Business Days, holiday calendars, and (currently) German legal deadline logic. All calculations run locally on the device, including audit table and counter-check for plausibility verification.

Quick Start

  • Open Calculator and select the appropriate settings at the top: SYS (System), REG (Region), CAL (Calendar), FMT(Display Format).

  • Choose a mode (T+N, ROLL, LAW, COUNT), set the date, press =.

  • Switch to Audit to see the tabular day list (Business/Non-Business + reasons) and the counter-check.

Tabs

  • Calculator: Calculate offsets, conventions, legal deadlines, and counts.

  • Calendars: Month/year overview with holidays and business day marking per day.

  • Audit: Table per date + Proof (counter-check) + Export.

  • Info: Brief info, logic, notes, and disclaimer.

Calculator Modes

  • T+N (Add Business Days): Adds/subtracts N Business Days from start date. Non-Business Days (weekends/holidays) are skipped. Note: T+N does not count the start day.

  • ROLL (Adjust Convention): Adjusts a date according to business day convention: Following, Preceding, Modified Following, Modified Preceding, Unadjusted.

  • LAW (Legal Deadline): Deadline calculation (currently Germany/BGB logic only) with start rule (start day included/excluded), period (days/weeks/months/years), and optional adjustment to business days.

  • COUNT (Count Between): Counts business days between start and end date, optionally including/excluding boundary dates.

Calendars (Built-in)

  • Germany: Federal states (state-specific holidays).

  • UK: Bank Holidays for England & Wales, Scotland, Northern Ireland including Substitute Days and selected special days.

  • USA: Federal Holidays including Observed Days (Fri/Mon for weekends).

  • EU: TARGET2 (Payment System) holidays.

  • Note: Holiday names are proper nouns and remain local (e.g., DE holidays in German).

Audit: Table

  • Columns:

    • #: Step/row.

    • Date: ISO date YYYY-MM-DD.

    • BD: Y (Business Day) or N (Non-Business Day).

    • Reason: Abbreviations to keep the list readable.

    • Count: Running business day counter (where applicable).

  • Abbreviations in Reason:

    • WE = Weekend.

    • HOL:<token> = Holiday (compact).

  • Long-press on Reason shows the full reason below as an overlay bubble (tap to dismiss).

Audit: Proof (Counter-Check)

  • Partition Check: Verifies that Business Days + Non-Business Days = Total Dates (quick consistency check).

  • Manual Counter vs Engine Counter: Simple counter-check based on the same day list.

  • Date Check: Compares Result (ISO) with the last trace date (should be PASS).

  • If Trace is truncated is displayed, the counter-check is based on partial data only.

Export & Share

  • Share as Text: Shares the report as text via iOS Share Sheet.

  • Share as Email: Opens an email (mailto) with subject and report text in body (for very long reports, the body will be truncated).

  • Copy Text: Copies the report text to clipboard.

Settings & Data

  • Settings are stored locally (calendar/system/format, etc.).

  • Audit shows the most recently calculated report; it is not automatically archived permanently.

  • All calculations are performed locally; content only leaves the device when sharing/email/clipboard (via iOS system functions).

Known Limitations

  • LAW (Legal Deadline) is currently only implemented for Germany/BGB; other jurisdictions are intentionally locked in this mode.

  • Very large time periods can slow down display/trace generation (especially COUNT with very long spans).

  • Special/exception holidays may vary by country/region; if you notice something, please report (ideally with audit export).

FAQ

  • "Why is a different date returned than expected?"

    • Check SYS/REG/CAL and whether ROLL/LAW settings are correct (start day rule, adjustment).

    • Check if a holiday is considered Observed/Substitute (USA/UK).

  • "Why don't I see every day in the audit?"

    • In LAW and COUNT, the day list is built from startISO to resultISO or endISO. If a report is old, please recalculate.

  • "Why is the reason truncated?"

    • The table shows abbreviations; long-press shows the full text.

  • "Share as Email doesn't open"

    • Make sure a mail client/account is configured on the device.

Privacy

  • KARL does not collect analytics and does not send data to servers.

  • Settings are stored locally.

  • Export/Share/Clipboard are actions intentionally triggered by the user.

Contact / Support

  • Email: kontakt@byzimmer.com

  • Please include:

    • App version (build), iOS version, device.

    • Mode (T+N/ROLL/LAW/COUNT), Calendar ID, inputs.

    • Expected result vs. actual result.

    • Audit export (preferably Share as Text).

KARL ist der präzise Business-Day- und Fristenrechner für juristische und finanzielle Workflows. Ob Vertragsfristen, Settlement-Dates oder Compliance-Deadlines – berechne Geschäftstage zuverlässig und dokumentiere jeden Schritt mit vollständigem Audit-Trace.

Für Juristen, Banker und Finance-Professionals

  • Business-Day Calculator (T+N): Addiere oder subtrahiere N Business Days ab einem Startdatum – Non-Business-Tage werden automatisch übersprungen

  • Roll Conventions: Passe Daten nach gängigen Marktstandards an (Following, Preceding, Modified Following, Modified Preceding, Unadjusted)

  • BGB-Fristenrechnung: Berechne gesetzliche Fristen nach deutschem Recht mit Startregel, Periode (Tage/Wochen/Monate/Jahre) und optionaler Business-Day-Anpassung

  • COUNT Between: Zähle Business Days zwischen zwei Daten – inklusive oder exklusive Grenzen

  • Kalender-Übersicht: Visualisiere Monate/Jahre mit Feiertagslisten und Business/Non-Business-Kennzeichnung pro Tag

  • Audit-Trace mit Proof: Tabellarischer Nachweis für jedes Datum mit Business-Day-Status, Begründung und Gegenrechnung zur Plausibilitätsprüfung

  • Export & Teilen: Berichte als Text teilen, per E-Mail versenden oder direkt in die Zwischenablage kopieren

Unterstützte Kalender ✓ Deutschland (alle Bundesländer) ✓ UK Bank Holidays (England & Wales, Scotland, Northern Ireland) ✓ US Federal Holidays ✓ TARGET2 (EU Payments)

Präzision trifft Transparenz KARL zeigt dir nicht nur das Ergebnis, sondern dokumentiert jeden Rechenschritt. Perfekt für Verträge, Compliance-Dokumentation und wenn jeder Tag zählt.

KARL ist ein Offline-Rechner für Business Days, Feiertagskalender und (derzeit) deutsche Fristenlogik. Alle Berechnungen laufen lokal auf dem Geraet, inkl. Audit-Tabelle und Gegenrechnung zur Plausibilitätspruefung.

Schnellstart

- Oeffne `Calculator` und waehle oben die passenden Settings: `SYS` (System), `REG` (Region), `CAL` (Kalender), `FMT` (Anzeigeformat).

- Waehle einen Modus (`T+N`, `ROLL`, `LAW`, `COUNT`), setze das Datum, druecke `=`.

- Wechsel zu `Audit`, um die tabellarische Tagesliste (Business/Non‑Business + Gruende) und die Gegenrechnung zu sehen.

Tabs

- `Calculator`: Berechnen von Offsets, Konventionen, Legal Deadlines und Counts.

- `Calendars`: Monats-/Jahresuebersicht mit Feiertagen und Business-Day-Markierung pro Tag.

- `Audit`: Tabelle je Datum + Proof (Gegenrechnung) + Export.

- `Info`: Kurzinfo, Logik, Hinweise und Disclaimer.

Calculator-Modi

- `T+N (Add Business Days)`: Addiert/subtrahiert N Business Days ab Startdatum. Non‑Business Days (Wochenende/Feiertage) werden uebersprungen. Hinweis: T+N zaehlt den Starttag nicht mit.

- `ROLL (Adjust Convention)`: Passt ein Datum nach Business‑Day‑Konvention an: `Following`, `Preceding`, `Modified Following`, `Modified Preceding`, `Unadjusted`.

- `LAW (Legal Deadline)`: Fristenberechnung (aktuell nur Deutschland/BGB‑Logik) mit Startregel (Starttag ein-/ausgeschlossen), Periode (Tage/Wochen/Monate/Jahre) und optionaler Anpassung auf Business Days.

- `COUNT (Count Between)`: Zaehlt Business Days zwischen Start- und Enddatum, optional inkl./exkl. der Randtage.

Kalender (Built-in)

- Deutschland: Bundeslaender (state-specific Feiertage).

- UK: Bank Holidays fuer `England & Wales`, `Scotland`, `Northern Ireland` inkl. Substitute Days und ausgewaehlter Sondertage.

- USA: Federal Holidays inkl. Observed Days (Fr/Mo bei Wochenenden).

- EU: `TARGET2` (Payment System) Feiertage.

- Hinweis: Feiertagsnamen sind Eigennamen und bleiben entsprechend lokal (z. B. DE-Feiertage auf Deutsch).

Audit: Tabelle

- Spalten:

- `#`: Schritt/Zeile.

- `Date`: ISO-Datum `YYYY-MM-DD`.

- `BD`: `Y` (Business Day) oder `N` (Non‑Business Day).

- `Reason`: Abkuerzungen, damit die Liste lesbar bleibt.

- `Count`: laufender Business-Day-Zaehler (wo sinnvoll).

- Abkuerzungen in `Reason`:

- `WE` = Weekend.

- `HOL:<token>` = Holiday (kompakt).

- Long‑Press auf `Reason` zeigt den vollstaendigen Grund unten als Overlay-Bubble (Tippen blendet sie wieder aus).

Audit: Proof (Gegenrechnung)

- `Partition Check`: prueft, dass `Business Days + Non‑Business Days = Total Dates` (schneller Konsistenzcheck).

- `Manual Counter` vs `Engine Counter`: einfache Gegenrechnung anhand derselben Tagesliste.

- `Date Check`: vergleicht `Result (ISO)` mit dem letzten Trace-Datum (sollte `PASS` sein).

- Wenn `Trace is truncated` angezeigt wird, basiert die Gegenrechnung nur auf Teildaten.

**Export & Teilen**

- `Share as Text`: teilt den Report als Text ueber das iOS Share Sheet.

- `Share as Email`: oeffnet eine E‑Mail (mailto) mit Betreff und Report-Text im Body (bei sehr langen Reports wird der Body gekuerzt).

- `Copy Text`: kopiert den Report-Text in die Zwischenablage.

Settings & Daten

- Einstellungen werden lokal gespeichert (Kalender/System/Format usw.).

- `Audit` zeigt den zuletzt berechneten Report; er wird nicht automatisch dauerhaft historisiert.

- Alle Berechnungen erfolgen lokal; nur beim Teilen/Email/Clipboard verlassen Inhalte optional das Geraet (ueber iOS-Systemfunktionen).

**Bekannte Einschraenkungen**

- `LAW (Legal Deadline)` ist aktuell nur fuer Deutschland/BGB implementiert; andere Jurisdiktionen sind in diesem Modus bewusst gesperrt.

- Sehr grosse Zeitraeume koennen die Anzeige/Trace-Generierung verlangsamen (insbesondere `COUNT` mit sehr langen Spannen).

- Sonder-/Ausnahmefeiertage koennen je nach Land/Region variieren; wenn dir etwas auffaellt, bitte melden (idealerweise mit Audit-Export).

FAQ

- “Warum kommt ein anderes Datum als erwartet?”

- Pruefe `SYS/REG/CAL` und ob `ROLL`/`LAW`-Einstellungen korrekt sind (Starttag-Regel, Adjustment).

- Pruefe, ob ein Feiertag als Observed/Substitute gilt (USA/UK).

- “Warum sehe ich im Audit nicht jeden Tag?”

- Im `LAW` und `COUNT` wird die Tagesliste aus `startISO` bis `resultISO` bzw. `endISO` aufgebaut. Wenn ein Report alt ist, bitte Berechnung erneut ausfuehren.

- “Warum ist der Grund abgeschnitten?”

- In der Tabelle wird abgekürzt; Long‑Press zeigt den Volltext.

- “Share as Email geht nicht auf”

- Stelle sicher, dass ein Mail-Client/Account auf dem Geraet eingerichtet ist.

Datenschutz

- KARL sammelt keine Analytik und sendet keine Daten an Server.

- Einstellungen werden lokal gespeichert.

- Export/Teilen/Clipboard sind bewusst vom Nutzer ausgeloeste Aktionen.

Kontakt / Support

- E‑Mail: kontakt@byzimmer.com

- Bitte mitschicken:

- App-Version (Build), iOS-Version, Gerätetyp (iPhone 17 etc.)

- Modus (`T+N/ROLL/LAW/COUNT`), Kalender-ID, Eingaben.

- Erwartetes Ergebnis vs. tatsaechliches Ergebnis.

- Audit-Export (am besten `Share as Text`).