Chinesischer Tierkreis und Kalender

Das Tier des Jahres ist der bekannteste Teil der Tradition und wird am häufigsten falsch berechnet. Das Jahr im BaZi beginnt nicht am 1. Januar und nicht mit dem chinesischen Neujahr, sondern mit 立春 Lichun, dem Moment, in dem die sichtbare Länge der Sonne 315° erreicht. Im Jahr 2026 ist das 2026-02-03T20:02:08Z, also der 4. Februar um 04:02 Uhr Pekinger Zeit. Eine am 2. Februar geborene Person gehört zum vorherigen Tier, obwohl der Wandkalender bereits das neue Jahr anzeigt.

Endpunkte

Endpunkt	Credits	Was zurückgegeben wird
POST /v1/chinese/zodiac/animal	10	Tier des Jahres, Säule, Elemente des Zweiges und des Stammes
POST /v1/chinese/zodiac/element	10	Festes Element des Zweiges und zyklisches Element des Stammes
POST /v1/chinese/zodiac/inner-animal	10	Inneres Tier: Monatszweig
POST /v1/chinese/zodiac/secret-animal	10	Geheimes Tier: Stundenzweig
POST /v1/chinese/zodiac/compatibility	10	Kompatibilität zweier Tiere nach 三合 und 六冲
POST /v1/chinese/lunar-date	10	Monddatum, Schaltmonat, chinesisches Neujahr
POST /v1/chinese/solar-terms	10	Alle 24 Begriffe des Jahres auf die Sekunde genau

Drei Tiere, nicht nur eines

Horoskope in Zeitschriften kennen ein Tier. Die Tradition kennt drei, und sie beantworten verschiedene Fragen.

Tier	Woher	Was es bedeutet
Äußeres	Jahreszweig	Wie die Person von anderen gesehen wird
Inneres	Monatszweig	Motive, privates “Ich”
Geheimes	Stundenzweig	Die tiefste Schicht, oft vor der Person selbst verborgen

Das innere Tier ist durch die genauen Momente 節 begrenzt, nicht durch die Mitte des Monats, daher können Geburten am 5. Mai und 6. Mai zu verschiedenen Tieren führen.

curl -X POST https://api.astroway.info/v1/chinese/zodiac/inner-animal \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-05-15","time":"14:30:00","timezoneOffset":3}'

{
  "ok": true,
  "data": {
    "innerAnimal": "Snake",
    "glyph": "🐍",
    "description": "Inner animal = the BaZi month branch, bounded by the exact 節 instants. Represents internal motivations and the private self."
  }
}

Zwei Elemente des Jahres

Eine 1990 geborene Person ist ein “Metallpferd”, und dieser Name enthält zwei verschiedene Elemente, die leicht zu verwechseln sind.

• Zyklisch kommt vom himmlischen Stamm und ändert sich alle zwei Jahre: 庚 ist Metall.
• Fest gehört für immer dem irdischen Zweig: 午 ist Feuer, und das Pferd ist immer feurig.

/chinese/zodiac/element gibt beide als separate Felder, fixedElement und cyclingElement, zurück, anstatt für den Client zu wählen.

Kompatibilität

Die Bewertung basiert auf 三合 (drei Harmonien) und 六冲 (sechs Kollisionen), d.h. auf der Geometrie des Zweigkreises und nicht auf einer Liste von Meinungen.

curl -X POST https://api.astroway.info/v1/chinese/zodiac/compatibility \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"person1":{"date":"1990-05-15"},"person2":{"date":"1988-02-20"}}'

{
  "person1": { "solarYear": 1990, "animal": "Horse" },
  "person2": { "solarYear": 1988, "animal": "Dragon" },
  "compatibility": {
    "score": 65,
    "category": "good",
    "notes": ["Compatible enough; complementary differences."]
  }
}

Tierkompatibilität ist eine Schicht, keine Karte

Der Vergleich der Jahrestiere ist der gröbste Schnitt: Er kennt von einer Person genau ein Schriftzeichen von acht. Für eine echte Lesung nimm /v1/bazi/chart von beiden und schau dir die Interaktionen aller vier Säulen an.

Monddatum

curl -X POST https://api.astroway.info/v1/chinese/lunar-date \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-02-17"}'

{
  "gregorianDate": "2026-02-17",
  "lunar": { "month": 1, "isLeapMonth": false, "day": 1, "monthStart": "2026-02-17", "label": "month 1, day 1" },
  "chineseNewYear": "2026-02-17"
}

Der Monat beginnt mit dem Pekinger Tag, der den Neumond enthält. Ein Schaltmonat wiederholt die Nummer des vorherigen Monats und enthält kein 中氣: Dies ist der Grund seiner Existenz, nicht ein Nebeneffekt.

Vor 1929

Der Kalender vor 1929 wird nach der Pekinger Ortszeit (UTC+7:45:40) berechnet, und dies ist eine historische Grundlage, nicht unsere Konvention. Ein Neumond, der auf die Minuten um Mitternacht fällt, kann den Monat einen Tag weiter vom gedruckten Almanach dieses Tages verschieben, da diese auf den Tag genau berechnet wurden.

Vierundzwanzig Sonnenbegriffe

Ein Begriff ist kein Datum aus einer Tabelle, sondern ein Moment, in dem die sichtbare Länge der Sonne ein Vielfaches von 15° wird. Wir entnehmen dies den Ephemeriden, daher ist die Antwort für jedes Jahr innerhalb der Domäne gleich und hängt nicht davon ab, ob jemand die Tabelle aktualisiert hat.

curl -X POST https://api.astroway.info/v1/chinese/solar-terms \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026}'

Das Array terms enthält alle vierundzwanzig; hier ist der erste gezeigt:

{
  "year": 2026,
  "terms": [
    {
      "index": 0,
      "chinese": "立春",
      "pinyin": "Lichun",
      "english": "Start of Spring",
      "sunLongitude": 315,
      "utc": "2026-02-03T20:02:08Z",
      "beijing": "2026-02-04T04:02:08+08:00",
      "opensPillarMonth": true
    }
  ]
}

Zwölf der vierundzwanzig tragen opensPillarMonth: true: Dies sind 節, die den Monat der Säulen eröffnen. Die restlichen zwölf sind 中氣, sie teilen den Monat in zwei Hälften und bestimmen, welcher Monat ein Schaltmonat sein wird.

Ein Begriff ist ein Moment, kein Tag, und sein Tag ist unterschiedlich

Lies utc und nicht beijing, wenn dein Benutzer nicht in China ist. China und Hongkong rechnen mit UTC+8, Japan und Korea mit UTC+9, Vietnam mit UTC+7, sodass eine Stunde von vierundzwanzig ein Fenster ist, in dem nationale Almanache verschiedene Kalendertage drucken. Im Durchschnitt ist das ein Begriff pro Jahr. Im Jahr 2026 sind es zwei: 雨水 ist der 18. Februar in Peking und der 19. Februar in Tokio, 芒種 ist der 5. und 6. Juni. Unsere Momente reproduzieren beide Veröffentlichungen auf die Minute genau.

Sprachen

Tiere und Elemente sind in 21 Sprachen übersetzt. Füge ?lang= oder "language" im Body hinzu, und neben dem englischen Token erscheint ein *Name-Feld:

curl -X POST "https://api.astroway.info/v1/chinese/zodiac/animal?lang=es" \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-05-15"}'

{ "animal": "Horse", "animalName": "Caballo", "element": { "fixed": "Fire", "fixedName": "Fuego" } }

Die englischen Felder bleiben dauerhaft erhalten: Die Lokalisierung fügt hinzu, ersetzt aber nicht.