/api/astro/nepali_calendar/1 CreditNepalesischer Kalender
Ein Jahr mit nepalesischen Festen und Festtagen nach dem Bikram-Sambat-Kalender. Der nepalesische Kalender ist ein Sonnenkalender: Jeder der zwölf Monate beginnt mit dem Eintritt der Sonne in ein siderisches Zeichen, der erste ist Baishakh. Die Antwort nennt das Bikram-Sambat-Jahr bzw. die beiden Bikram-Sambat-Jahre, die das angefragte gregorianische Jahr abdecken. Die Ereignisliste enthält jede Sankranti unter ihrem nepalesischen Namen (Maghe, Falgun, Baishakh und so weiter), alle Ekadashis, beide Pradosh-Vrats jedes Monats – benannt nach ihrem Wochentag –, die Finsternisse und Nationalfeste wie Nawa Barsha und Bisket Jatra. Übergib das Jahr mit Breitengrad, Längengrad und UTC-Offset. Beachte: Die Nepal Standard Time ist UTC+05:45, für Kathmandu muss timezone_as_float also 5.75 sein; mit 5.5 verschieben sich die Tagesgrenzen. Die Antwort ist {year, bikram_sambat, events}, jedes Ereignis hat die Form {name, date}. Das Jahr muss zwischen 2006 und 2046 liegen. Für den Monatsbeginn gilt die übliche Praxis: Eine Sankranti wird auf den Tag des Übergangs datiert, wenn dieser vor Sonnenuntergang stattfindet, sonst auf den folgenden Tag. Die offiziellen Monatsanfänge in Nepal legt ein Komitee fest, statt sie aus einem einzigen astronomischen Kriterium abzuleiten. Deshalb weichen pro Jahrzehnt einige wenige Übergänge vom veröffentlichten Patro ab.
https://api.occultapi.com/api/astro/nepali_calendar/
Authentifizierung
Schick deinen Schlüssel im Header X-API-Key mit. API-Schlüssel sind Zugangsdaten für den Server: Sie gehören nie in Browser-JavaScript oder in eine mobile App.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonFelder 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. |
| year | integer | Pflicht | Geburtsjahr als Zahl, z. B. 1990. Vier Ziffern. min 2006 · max 2046 |
Beispielanfrage
curl -X POST https://api.occultapi.com/api/astro/nepali_calendar/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"year":2026}'Antwort
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"year\": 2026, \"bikram_sambat\": \"2082 - 2083\", \"events\": [{\"name\": \"Guru Pradosh Vrat\", \"date\": \"2026-01-01\"}, {\"name\": \"Maghe Sankranti\", \"date\": \"2026-01-14\"}, {\"name\": \"Sat-Tila Ekadashi\", \"date\": \"2026-01-14\"}, {\"name\": \"Shukra Pradosh Vrat\", \"date\": \"2026-01-16\"}, {\"name\": \"Shree Panchami\", \"date\": \"2026-01-23\"}, {\"name\": \"Bhima Ekadashi\", \"date\": \"2026-01-29\"}, {\"name\": \"Shukra Pradosh Vrat\", \"date\": \"2026-01-30\"}, {\"name\": \"Falgun Sankranti\", \"date\": \"2026-02-13\"}, {\"name\": \"Vijaya Ekadashi\", \"date\": \"2026-02-13\"}, {\"name\": \"Shani Pradosh Vrat\", \"date\": \"2026-02-14\"}, {\"name\": \"Maha Shivaratri\", \"date\": \"2026-02-15\"}, {\"name\": \"Surya Grahan *Valayakara\", \"date\": \"2026-02-17\"}, {\"name\": \"Amalaki Ekadashi\", \"date\": \"2026-02-27\"}, {\"name\": \"Ravi Pradosh Vrat\", \"date\": \"2026-03-01\"}, {\"name\": \"Chandra Grahan *Purna\", \"date\": \"2026-03-03\"}, {\"name\": \"Fagu Poornima\", \"date\": \"2026-03-03\"}, {\"name\": \"Chaitra Sankranti\", \"date\": \"2026-03-15\"}, {\"name\": \"Papamochani Ekadashi\", \"date\": \"2026-03-15\"}, {\"name\": \"Soma Pradosh Vrat\", \"date\": \"2026-03-16\"}, {\"name\": \"Ram Nawami\", \"date\": \"2026-03-26\"}, {\"name\": \"Kamada Ekadashi\", \"date\": \"2026-03-29\"}, {\"name\": \"Soma Pradosh Vrat\", \"date\": \"2026-03-30\"}, {\"name\": \"Hanuman Jayenti\", \"date\": \"2026-04-02\"}, {\"name\": \"Hanuman Janmotsava\", \"date\": \"2026-04-02\"}, {\"name\": \"Baruthini Ekadashi\", \"date\": \"2026-04-13\"}, {\"name\": \"Baishakh Sankranti\", \"date\": \"2026-04-14\"}, {\"name\": \"Nawa Barsha\", \"date\": \"2026-04-14\"}, {\"name\": \"Bisket Jatra\", \"date\": \"2026-04-14\"}, {\"name\": \"Budha Pradosh Vrat\", \"date\": \"2026-04-15\"}, {\"name\": \"Parasuram Jayenti\", \"date\": \"2026-04-19\"}, {\"name\": \"Aachya Tritiya\", \"date\": \"2026-04-20\"}, {\"name\": \"Sita Jayanti\", \"date\": \"2026-04-25\"}, {\"name\": \"Mohini Ekadashi\", \"date\": \"2026-04-27\"}, {\"name\": \"Bhauma Pradosh Vrat\", \"date\": \"2026-04-28\"}, {\"name\": \"Buddha Jayanti\", \"date\": \"2026-05-01\"}, {\"name\": \"Apara Ekadashi\", \"date\": \"2026-05-13\"}, {\"name\": \"Guru Pradosh Vrat\", \"date\": \"2026-05-14\"}, {\"name\": \"Jeshta Sankranti\", \"date\": \"2026-05-15\"}, {\"name\": \"Guru Pradosh Vrat\", \"date\": \"2026-05-28\"}, {\"name\": \"Parama Ekadashi\", \"date\": \"2026-06-11\"}, {\"name\": \"Shukra Pradosh Vrat\", \"date\": \"2026-06-12\"}, {\"name\": \"Asar Sankranti\", \"date\": \"2026-06-15\"}, {\"name\": \"Nirjala Ekadashi\", \"date\": \"2026-06-25\"}, {\"name\": \"Shani Pradosh Vrat\", \"date\": \"2026-06-27\"}, {\"name\": \"Yogini Ekadashi\", \"date\": \"2026-07-10\"}, {\"name\": \"Ravi Pradosh Vrat\", \"date\": \"2026-07-12\"}, {\"name\": \"Shrawane Sankranti\", \"date\": \"2026-07-17\"}, {\"name\": \"Harisayani Ekadashi\", \"date\": \"2026-07-25\"}, {\"name\": \"Ravi Pradosh Vrat\", \"date\": \"2026-07-26\"}, {\"name\": \"Kamika Ekadashi\", \"date\": \"2026-08-09\"}, {\"name\": \"Soma Pradosh Vrat\", \"date\": \"2026-08-10\"}, {\"name\": \"Surya Grahan *Purna\", \"date\": \"2026-08-12\"}, {\"name\": \"Bhadra Sankranti\", \"date\": \"2026-08-17\"}, {\"name\": \"Putrada Ekadashi\", \"date\": \"2026-08-23\"}, {\"name\": \"Bhauma Pradosh Vrat\", \"date\": \"2026-08-25\"}, {\"name\": \"Chandra Grahan *Anshika\", \"date\": \"2026-08-28\"}, {\"name\": \"Janai Purnima\", \"date\": \"2026-08-28\"}, {\"name\": \"Kwati Punhi\", \"date\": \"2026-08-28\"}, {\"name\": \"Rakshya Bandhan\", \"date\": \"2026-08-28\"}, {\"name\": \"Gai Jatra\", \"date\": \"2026-08-29\"}, {\"name\": \"Shree Krishna Janmastami\", \"date\": \"2026-09-04\"}, {\"name\": \"Aja Ekadashi\", \"date\": \"2026-09-07\"}, {\"name\": \"Bhauma Pradosh Vrat\", \"date\": \"2026-09-08\"}, {\"name\": \"Hartalika Teej\", \"date\": \"2026-09-14\"}, {\"name\": \"Ganesh Chaturthi\", \"date\": \"2026-09-14\"}, {\"name\": \"Rishi Panchami\", \"date\": \"2026-09-15\"}, {\"name\": \"Ashoj Sankranti\", \"date\": \"2026-09-17\"}, {\"name\": \"Bishwakarma Pooja\", \"date\": \"2026-09-17\"}, {\"name\": \"Radhastami\", \"date\": \"2026-09-19\"}, {\"name\": \"Hari-Parivartan Ekadashi\", \"date\": \"2026-09-22\"}, {\"name\": \"Indra Jatra\", \"date\": \"2026-09-23\"}, {\"name\": \"Guru Pradosh Vrat\", \"date\": \"2026-09-24\"}, {\"name\": \"Pitrupaksha Arambha\", \"date\": \"2026-09-27\"}, {\"name\": \"Pratiprada Shradham\", \"date\": \"2026-09-27\"}, {\"name\": \"Indira Ekadashi\", \"date\": \"2026-10-06\"}, {\"name\": \"Guru "
}Aus einem echten Aufruf mit genau dieser Anfrage. Die Ergebnisse stehen unter data.
Fehler
Abrechnungsfehler liefern { "error": "…", "message": "<code>", "is_error": true }. Zeig deinen Nutzern error an und verzweige im Code anhand von message. Details in der Fehlerreferenz.