ForHosting KIT · Entwickler-Tools

Chinesisches Tierkreiszeichen nach Jahr: Tier und Element

Geben Sie ein Geburtsjahr ein, um das Tier und Element des chinesischen Tierkreises nach dem traditionellen 60-Jahre-Zyklus zu bestimmen.

● BetaKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Das Ergebnis ergänzt die zwölf bekannten Tiere um Holz, Feuer, Erde, Metall oder Wasser, die Yin- oder Yang-Polarität sowie den zugehörigen Himmelsstamm und Erdzweig. Die feste modulare Berechnung ist unmittelbar, reproduzierbar und eignet sich für Nachschlagewerke, Lernmaterial, Formulare und Anwendungen, die strukturierte Tierkreisdaten ohne externen Kalenderdienst benötigen.

Was das Ergebnis für ein Jahr bedeutet

Der chinesische Tierkreis wird häufig als wiederkehrende Folge von zwölf Tieren vorgestellt. Eine vollständige Jahresbezeichnung enthält jedoch zusätzlich eines von fünf Elementen und eine Yin- oder Yang-Polarität. Diese Bestandteile entstehen aus der Verbindung der zwölf Erdzweige mit den zehn Himmelsstämmen. Da beide Folgen unterschiedlich lang sind, kehrt dieselbe vollständige Kombination erst nach sechzig Jahren zurück. Der Rechner liefert Tier, Element, Polarität, Stamm, Zweig und Position innerhalb dieser Folge. Menschen, deren Geburtsjahre zwölf Jahre auseinanderliegen, haben gewöhnlich dasselbe Tier, können aber unterschiedliche Elemente besitzen, weil die Stammfolge weitergelaufen ist. Die zusammenfassende Bezeichnung eignet sich zum Lesen; getrennte Felder sind besser für Software, Tabellen, Filter und Vorlagen. Verstehen Sie das Ergebnis als traditionelle Jahresklassifikation, nicht als wissenschaftliche Persönlichkeitsanalyse oder Vorhersage zu Charakter, Partnerschaft, Gesundheit, Glück oder zukünftigen Ereignissen.

So funktioniert die Berechnung des 60-Jahre-Zyklus

Als Bezugspunkt dient 1984, die erste Zyklusposition: das Jahr der Yang-Holz-Ratte, nach Himmelsstamm und Erdzweig auch Jia-Zi genannt. Durch das Abziehen von vier werden gregorianische Jahreszahlen an den Anfangsindizes Ratte und Jia ausgerichtet. Positiver Modulo zwölf bestimmt Tier und Zweig, Modulo zehn Stamm, Element und Polarität, und Modulo sechzig ergibt eine Position von 1 bis 60. Der positive Modulo hält die Folge auch für frühere Jahre konsistent. Aktuelle Uhrzeit, Regionseinstellung, Netzwerk, Zufall und externe Kalenderdatenbanken beeinflussen das Ergebnis nicht. Daher erzeugt dieselbe gültige Ganzzahl stets dasselbe Objekt. Akzeptiert werden ganzzahlige Zahlen und streng formatierte Ganzzahl-Zeichenketten, auch mit äußeren Leerzeichen oder Vorzeichen. Dezimalzahlen, Exponentialschreibweise, fehlende Werte, unsichere Ganzzahlen und Texte, die nur mit Ziffern beginnen, werden abgelehnt.

Das Ergebnis in Anwendungen korrekt einsetzen

Verwenden Sie die Antwort, wenn ein Projekt eine herkömmliche Tierkreiszuordnung allein anhand eines gregorianischen Geburtsjahres benötigt. Sie eignet sich für Profilanreicherung, Unterrichtsaufgaben, Veranstaltungsthemen, personalisierte Grußkarten, Referenztabellen und kleine Kulturfunktionen. Beachten Sie, dass das traditionelle Tierkreisjahr zum Mondneujahr und nicht am 1. Januar wechselt. Wer im Januar oder Anfang Februar geboren wurde, kann abhängig vom genauen Datum noch zum vorherigen Tierkreisjahr gehören. Da diese Fähigkeit nur eine Jahreszahl erhält, kann sie diesen Grenzfall nicht lösen. Fragen Sie nach dem vollständigen Geburtsdatum und verwenden Sie bei Bedarf ein mondkalenderfähiges Werkzeug. Speichern Sie Tier und Element als strukturierte Felder, statt die Bezeichnung zu zerlegen; so lassen sie sich leichter übersetzen und abfragen. Jede API-Anfrage kostet $0.002. Ungültige Eingaben führen zu einem eindeutigen Fehler, ohne Dezimalwerte zu runden, Ziffern aus Text zu ziehen oder stillschweigend das aktuelle Jahr einzusetzen.

Anwendungsfälle

Ein Profil nach Geburtsjahr ergänzen

Ergänzen Sie strukturierte Felder für Tier, Element, Polarität, Stamm und Zweig, wenn nur das Geburtsjahr vorliegt.

Eine Lehrtabelle zum Zyklus erstellen

Erzeugen Sie konsistente Beispiele dafür, wie zwölf Tiere und zehn Stämme eine wiederkehrende 60-Jahre-Folge bilden.

Thematische Inhalte personalisieren

Wählen Sie jahresbezogene Bilder, Texte oder Kategorien anhand eines stabilen Ergebnisses ohne eigene Nachschlagetabelle.

Häufige Fragen

Was kostet eine Anfrage?

Jede API-Anfrage kostet $0.002.

Warum enthält das Ergebnis neben dem Tier ein Element?

Das Tier folgt zwölf Zweigen, das Element den zehn Himmelsstämmen. Gemeinsam bilden sie den vollständigen 60-Jahre-Zyklus.

Berücksichtigt der Rechner das Mondneujahr?

Nein. Er ordnet nur eine gregorianische Jahreszahl zu. Bei Geburten nahe dem Mondneujahr können das genaue Datum und eine Mondkalenderberechnung nötig sein.

Kann ich das Jahr als Text senden?

Ja. Eine Zeichenkette nur aus optionalem Vorzeichen und Ziffern wird akzeptiert. Dezimal-, Exponential-, leere und gemischte Angaben werden abgelehnt.

Was bezeichnet die Zyklusposition?

Sie ist der nummerierte Platz von 1 bis 60 im wiederkehrenden Stamm-Zweig-Zyklus, wobei 1984 die Position 1 bildet.

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/misc2/chinese-zodiac-from-year

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/misc2/chinese-zodiac-from-year \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990}'

const res = await fetch("https://api.kit.forhosting.com/misc2/chinese-zodiac-from-year", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "year": 1990
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/misc2/chinese-zodiac-from-year",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "year": 1990
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/misc2/chinese-zodiac-from-year", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"year":1990}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"year":1990}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/misc2/chinese-zodiac-from-year", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "year": 1990
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "misc2.chinese_zodiac_from_year",
  "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 →