Der vaishnavitische Kalender von ISKCON: ein ganzes Jahr mit Ekadashis, den Erscheinungs- und Verschwindenstagen der Acharyas und den großen Festen, datiert nach der Gaudiya-Zählung statt nach der allgemeinen hinduistischen. Die Monate tragen die zwölf Namen Vishnus – Madhava, Govinda, Damodara und die übrigen –, die beiden Monatshälften heißen Krishna und Gaura, und die Jahre werden in der Gaurabda-Ära gezählt.
Übergib ein Jahr sowie Breitengrad, Längengrad und UTC-Offset, denn die beim lokalen Sonnenaufgang gültige Tithi entscheidet, auf welchen bürgerlichen Tag ein Festtag fällt. Die Antwort ist {year, events}, jedes Ereignis hat die Form {name, date, masa, paksa, tithi_number, is_adhika, gaurabda_year}. Du erhältst also das gregorianische Datum und zugleich die vaishnavitischen Koordinaten, aus denen es sich ergibt; is_adhika markiert ein Ereignis in einem Schaltmonat.
Die Berechnung von Tithi und Monat folgt der GCAL-Spezifikation, die auch ISKCONs eigene Kalendersoftware nutzt, und weicht bewusst von der Methode mit siderischen Ephemeriden hinter /api/astro/panchanga/ ab. Die Daten können deshalb um einen Tag von anderen Endpoints hier abweichen. Ein Jahr umfasst mehrere hundert Ereignisse; filtere oder paginiere sie daher clientseitig.
Felder der Anfrage
Feld
Typ
Pflicht
Hinweise
latitude
number (double)
Pflicht
Breitengrad des Ortes in Dezimalgrad. Positiv ist Nord, negativ ist Süd. Beispiel: 26.9124 für Jaipur, 40.7128 für New York. Minuten und Sekunden werden nicht akzeptiert – vorher umrechnen.
longitude
number (double)
Pflicht
Längengrad des Ortes in Dezimalgrad. Positiv ist Ost, negativ ist West. Beispiel: 75.7873 für Jaipur, -74.0060 für New York. Achte auf das Vorzeichen: Ein fehlendes Minus verlegt New York nach China.
timezone_as_float
number (double)
Pflicht
UTC-Offset des Ortes in Stunden, als Dezimalzahl. Beispiel: 5.5 für Indien (UTC+05:30), -5 für New York im Winter, 5.75 für Nepal. Wird NICHT gegen date_time validiert – stimmen beide nicht überein, erhältst du eine erfolgreiche Antwort für den falschen Zeitpunkt; leite daher beide aus derselben Quelle ab. Nutze den an diesem Datum gültigen Offset, nicht den heutigen: Eine Sommergeburt in einem Land mit Sommerzeit braucht den Sommer-Offset.