Über dieses Projekt

Dieser Kalender löst sich vom gregorianischen Kalender und orientiert sich stattdessen an realen astronomischen Ereignissen. Bisher festgelegt:

• Der Jahresnullpunkt liegt jährlich am exakten Zeitpunkt der Wintersonnenwende (Nordhalbkugel).
• Ein Jahr ist die reale Zeitspanne zwischen zwei aufeinanderfolgenden Wintersonnenwenden – live astronomisch berechnet, nicht pauschal angenommen.
• Monate orientieren sich am echten synodischen Mondzyklus: Ein Monat endet an dem Tag, dessen folgende Nacht Neumond ist. Monate sind dadurch 29 oder 30 Tage lang.
• Wie die Differenz zwischen den Mondmonaten und dem Sonnenjahr ausgeglichen wird (Schaltmonat oder ein Block aus Zusatztagen), ist noch offen.

Dieses Regelwerk wird laufend erweitert und verfeinert.

Kompaso (Kalenderansicht)

Die Startseite (index.php) zeigt standardmässig den Monat des heutigen Tages. Über URL-Parameter lässt sich gezielt zu einem bestimmten Tag springen:

• ?date=YYYY-MM-DD – springt zu einem gregorianischen Datum, z.B. index.php?date=2026-10-11
• ?kompaso=K-JJ-ZZ-TT – springt direkt zu einem Kompaso-Datum, z.B. index.php?kompaso=K-55-X-20 (auch die Sonderformen K-JJ-N-0 für Yul und K-JJ-0-0 für den Tag der Unendlichkeit funktionieren)

Sind beide Parameter gleichzeitig gesetzt, hat kompaso Vorrang. Ohne Parameter (nur index.php) wird immer der heutige Tag angezeigt – das nutzen auch der "‹"/"›"-Navigation und der "Heute"-Link auf der Seite selbst.

Kalender abonnieren (WebCAL)

Kompaso lässt sich als laufend aktualisierter Kalender in andere Programme einbinden – als Ganztages-Termine, 6 Monate rückwirkend bis 1 Jahr voraus. Einmal abonniert, holt sich die jeweilige App neue Termine automatisch selbst nach, ohne dass du etwas manuell exportieren oder erneut importieren musst. Das funktioniert unter anderem in:

• Thunderbird (Desktop) – Kalender hinzufügen → "Im Netzwerk" → WebCAL-Adresse eintragen
• Outlook (Desktop & Web) – Kalender hinzufügen → "Aus dem Internet abonnieren"
• iPhone/iPad – Einstellungen → Kalender → Account hinzufügen → "Kalenderabo hinzufügen"
• Android – meist über Google Kalender im Browser ("Fremden Kalender hinzufügen per URL") oder eine Kalender-App mit WebCAL-Unterstützung

Jetzt abonnieren (WebCAL)

API

Für eigene Skripte, Widgets oder Websites gibt es zusätzlich eine JSON-Schnittstelle: ein gregorianisches Datum rein, alle Kompaso-Werte für diesen Tag als JSON zurück (Jahr, Monatsname, Kompaso-Datum, Tzolk'in/ Tonalpōhualli, rückläufige Planeten, Ereignisse des Tages). Details und Beispiele auf der API-Seite.