ForHosting KIT · Entwickler-Tools

Maya-Langzählung aus Datum

Dieser Rechner wandelt ein ausdrücklich angegebenes gregorianisches Datum in die fünf bekannten Stellen der Maya-Langzählung um: Baktun, Katun, Tun, Uinal und Kin.

● BetaKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Er nutzt die Goodman-Martinez-Thompson-Korrelation 584,283 und behandelt die Eingabe strikt als UTC-Kalendertag. Das Ergebnis hängt daher weder von der Zeitzone des Geräts noch von Sommerzeitregeln ab. Die Antwort enthält außerdem die punktgetrennte Schreibweise, die julianische Tagesnummer und die für die Berechnung verwendete Anzahl vergangener Tage. So können Sie die Umrechnung bequem prüfen, zitieren, testen oder einbinden.

Geben Sie einen genauen gregorianischen Kalendertag ein

Verwenden Sie für das Datum das strenge Format YYYY-MM-DD und setzen Sie bei einstelligen Monaten oder Tagen eine führende Null. Der 21. Dezember 2012 wird beispielsweise als 2012-12-21 eingegeben. Der Rechner akzeptiert die Jahre 0001 bis 9999 und verwendet für den gesamten Bereich den proleptischen gregorianischen Kalender. Die bekannten gregorianischen Schaltjahrregeln werden somit auch auf historische Zeiträume vor der amtlichen Einführung dieses Kalenders in den einzelnen Ländern angewandt. Die Eingabe ist ein Kalendertag und kein Zeitstempel: Sie enthält weder Uhrzeit noch Versatz, Ort, Sommerzeitwechsel oder ein implizites aktuelles Datum. Dadurch bleiben wiederholte Aufrufe in jeder Umgebung stabil. Unmögliche Daten wie 2023-02-29, falsch formatierte Werte, Zeitstempel und fehlende Angaben werden abgelehnt und nicht stillschweigend normalisiert. Wenn Ihre historische Quelle den julianischen Kalender verwendet, rechnen Sie das Quelldatum zuerst in den entsprechenden gregorianischen Tag um. Dieser eindeutige Eingabevertrag verhindert, dass eine abweichende Kalenderbezeichnung wie ein Fehler der Maya-Berechnung erscheint.

Korrelation und Berechnung verstehen

Für eine Umrechnung der Langzählung muss die Maya-Chronologie mit dem System julianischer Tagesnummern moderner Kalenderberechnungen verknüpft werden. Dieses Werkzeug nennt seine Wahl ausdrücklich: die Goodman-Martinez-Thompson-Konstante, kurz GMT, mit dem Wert 584,283. Zunächst wird der angegebene proleptisch gregorianische Tag durch Ganzzahlarithmetik in eine ganzzahlige julianische Tagesnummer umgerechnet. Danach werden 584,283 abgezogen, um die seit der korrelierten Epoche der Langzählung vergangenen Kin zu erhalten. Diese Summe wird von der größten bis zur kleinsten Einheit zerlegt. Ein Baktun umfasst 144,000 Tage, ein Katun 7,200, ein Tun 360, ein Uinal 20 und ein Kin genau einen Tag. Der Baktun-Wert wird nach dreizehn nicht künstlich zurückgesetzt; deshalb bleiben Daten nach 13.0.0.0.0 geordnet und eindeutig. Andere wissenschaftliche Korrelationsvorschläge können demselben gregorianischen Tag eine andere Langzählung zuweisen. Das ausgegebene Korrelationsetikett und die julianische Tagesnummer sind daher wichtig: Sie dokumentieren die verwendete Konvention und liefern Zwischenwerte für eine unabhängige Prüfung.

Ausgabefelder lesen und weiterverwenden

Das Hauptergebnis ist die punktgetrennte Zeichenfolge long_count in der Reihenfolge baktun.katun.tun.uinal.kin. Dieselben fünf Stellen werden zusätzlich als einzelne Ganzzahlfelder ausgegeben. Das erleichtert Sortierung, Anzeigevorlagen, Datenbankspalten und weitere Berechnungen. total_days ist die vollständige Zahl der Kin seit der gewählten korrelierten Epoche; julian_day_number hält die Tagesnummer des gregorianischen Datums als Zwischenergebnis fest. date wiederholt die geprüfte Eingabe unverändert, und correlation bezeichnet die verwendete GMT-Konstante. Die Implementierung führt ausschließlich begrenzte Ganzzahloperationen aus und fragt weder Uhr noch plattformeigenen Datumsparser, Zufallsgenerator oder entfernten Dienst ab. Identische Eingaben erzeugen deshalb immer dasselbe JSON. Das eignet sich für Lehrchronologien, Museumskataloge, reproduzierbare Forschungsnotizen, Testdaten und API-Abläufe. Für einzelne Abfragen steht die Browserversion bereit; automatisierte Anfragen kosten jeweils $0.002. Bewahren Sie beim Veröffentlichen oder Austauschen eines Ergebnisses das Korrelationsetikett auf, besonders beim Vergleich mit Quellen, die möglicherweise eine andere Konvention verwenden.

Anwendungsfälle

Historische Zeitleiste ergänzen

Ergänzen Sie gregorianische Daten in Ausstellungen, Artikeln oder Lehrchronologien um eine einheitlich korrelierte Maya-Langzählung.

Katalogeinträge überprüfen

Berechnen Sie punktgetrennte Langzählungen aus gespeicherten gregorianischen Daten neu und halten Sie Korrelation und julianische Tagesnummer fest.

Reproduzierbare Datums-Testdaten erstellen

Erzeugen Sie deterministische Beispiele zur Kalenderumrechnung für Softwaretests, unabhängig von Systemzeitzone und Datumsparser.

Häufige Fragen

Welche Maya-Korrelation verwendet dieser Rechner?

Er nutzt die Korrelationskonstante Goodman-Martinez-Thompson 584,283 und weist diese Konvention in jedem Ergebnis aus.

Wofür stehen die einzelnen Positionen?

Von links nach rechts sind es Baktun, Katun, Tun, Uinal und Kin: Einheiten von 144,000, 7,200, 360, 20 und 1 Tag.

Verändert meine Zeitzone die Antwort?

Nein. Die Eingabe gilt als ausdrücklich angegebener UTC-Kalendertag; die Berechnung fragt keine lokale Uhr oder Zeitzone ab.

Warum kann ein anderer Rechner einen anderen Wert anzeigen?

Er könnte eine andere Korrelationskonstante nutzen, die Quelle als julianisches statt gregorianisches Datum lesen oder einen Zeitstempel lokal auswerten.

Was kostet eine Umrechnung über die API?

Jede API-Anfrage kostet $0.002. Für einzelne Umrechnungen können Sie den Rechner im Browser ohne API-Aufruf verwenden.

Für Entwickler — API-Zugang

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

Endpunkt

POSThttps://api.kit.forhosting.com/date/maya-long-count

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

Aufruf aus Ihrem Stack

curl -X POST https://api.kit.forhosting.com/date/maya-long-count \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2012-12-21"}'

const res = await fetch("https://api.kit.forhosting.com/date/maya-long-count", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "date": "2012-12-21"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/maya-long-count",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2012-12-21"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/maya-long-count", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"date":"2012-12-21"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"date":"2012-12-21"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/maya-long-count", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "date": "2012-12-21"
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.maya_long_count",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Preis

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →