Κινέζιο ζώδιο και ημερολόγιο

Το Ζώο του Έτους είναι το πιο γνωστό μέρος της παράδοσης και συχνά υπολογίζεται λανθασμένα. Το έτος στο BaZi δεν ξεκινά την 1η Ιανουαρίου ούτε με την Κινεζική Πρωτοχρονιά, αλλά με το 立春 Lichun, τη στιγμή που το φαινόμενο γεωγραφικό μήκος του Ήλιου φτάνει τις 315°. Το 2026 αυτό είναι 2026-02-03T20:02:08Z, δηλαδή 4 Φεβρουαρίου στις 04:02 ώρα Πεκίνου. Όποιος γεννήθηκε στις 2 Φεβρουαρίου ανήκει στο προηγούμενο ζώο, παρόλο που το ημερολόγιο στον τοίχο δείχνει ήδη το νέο έτος.

Τελικά σημεία (Endpoints)

Endpoint	Πόντοι	Τι επιστρέφει
POST /v1/chinese/zodiac/animal	10	Ζώο του έτους, στύλος, στοιχεία κλάδου και κορμού
POST /v1/chinese/zodiac/element	10	Σταθερό στοιχείο κλάδου και κυκλικό στοιχείο κορμού
POST /v1/chinese/zodiac/inner-animal	10	Εσωτερικό ζώο: κλάδος του μήνα
POST /v1/chinese/zodiac/secret-animal	10	Μυστικό ζώο: κλάδος της ώρας
POST /v1/chinese/zodiac/compatibility	10	Συμβατότητα δύο ζώων σύμφωνα με 三合 και 六冲
POST /v1/chinese/lunar-date	10	Σεληνιακή ημερομηνία, δίσεκτος μήνας, Κινεζική Πρωτοχρονιά
POST /v1/chinese/solar-terms	10	Όλοι οι 24 όροι του έτους με ακρίβεια δευτερολέπτου

Τρία ζώα, όχι ένα

Τα ωροσκόπια στα περιοδικά γνωρίζουν ένα ζώο. Η παράδοση γνωρίζει τρία, και αυτά απαντούν σε διαφορετικά ερωτήματα.

Ζώο	Από πού	Τι σημαίνει
Εξωτερικό	κλάδος του έτους	Το πώς βλέπουν οι άλλοι το άτομο
Εσωτερικό	κλάδος του μήνα	Κίνητρα, ο ιδιωτικός “εαυτός”
Μυστικό	κλάδος της ώρας	Το βαθύτερο στρώμα, συχνά κρυμμένο από το ίδιο το άτομο

Το εσωτερικό ζώο περιορίζεται από τις ακριβείς στιγμές 節, και όχι από τη μέση του μήνα, επομένως η γέννηση στις 5 Μαΐου και στις 6 Μαΐου μπορεί να δώσει διαφορετικά ζώα.

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."
  }
}

Δύο στοιχεία του έτους

Όποιος γεννήθηκε το 1990 είναι “μεταλλικό άλογο”, και σε αυτό το όνομα υπάρχουν δύο διαφορετικά στοιχεία που είναι εύκολο να μπερδευτούν.

• Κυκλικό προέρχεται από τον ουράνιο κορμό και αλλάζει κάθε δύο χρόνια: 庚 είναι μέταλλο.
• Σταθερό ανήκει στον επίγειο κλάδο για πάντα: 午 είναι φωτιά, και το άλογο είναι πάντα πύρινο.

Το /chinese/zodiac/element επιστρέφει και τα δύο σε ξεχωριστά πεδία, fixedElement και cyclingElement, αντί να επιλέγει για τον πελάτη.

Συμβατότητα

Η αξιολόγηση βασίζεται στο 三合 (τρεις αρμονίες) και στο 六冲 (έξι συγκρούσεις), δηλαδή στη γεωμετρία του κύκλου των κλάδων, και όχι σε μια λίστα απόψεων.

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."]
  }
}

Η συμβατότητα των ζώων είναι ένα στρώμα, όχι ένας χάρτης

Η σύγκριση των ζώων του έτους είναι η πιο χονδροειδής τομή: γνωρίζει για το άτομο ακριβώς ένα ιερογλυφικό από τα οκτώ. Για μια πραγματική ανάγνωση, πάρε το /v1/bazi/chart και των δύο και δες τις αλληλεπιδράσεις και των τεσσάρων στύλων.

Σεληνιακή ημερομηνία

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"
}

Ο μήνας ξεκινά με την ημέρα του Πεκίνου που περιέχει τη νέα σελήνη. Ο δίσεκτος μήνας επαναλαμβάνει τον αριθμό του προηγούμενου και δεν περιέχει 中氣: αυτός είναι ο λόγος ύπαρξής του, και όχι μια παρενέργεια.

Πριν από το 1929

Το ημερολόγιο πριν από το 1929 υπολογίζεται με βάση την τοπική μέση ώρα του Πεκίνου (UTC+7:45:40), και αυτή είναι η ιστορική βάση, όχι η δική μας σύμβαση. Η νέα σελήνη, που συμπίπτει με λεπτά κοντά στα τοπικά μεσάνυχτα, μπορεί να μετατοπίσει τον μήνα μία ημέρα μετά από τον έντυπο αλμανάκ εκείνης της εποχής, επειδή αυτοί υπολογίζονταν με ακρίβεια ημέρας.

Είκοσι τέσσερις ηλιακοί όροι

Ο όρος δεν είναι μια ημερομηνία από έναν πίνακα, αλλά μια στιγμή που το φαινόμενο γεωγραφικό μήκος του Ήλιου γίνεται πολλαπλάσιο του 15°. Την παίρνουμε από τις εφημερίδες, επομένως η απάντηση είναι ίδια για οποιοδήποτε έτος εντός του πεδίου και δεν εξαρτάται από το αν κάποιος ενημέρωσε τον πίνακα.

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}'

Ο πίνακας terms περιέχει και τους είκοσι τέσσερις· εδώ εμφανίζεται ο πρώτος:

{
  "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
    }
  ]
}

Δώδεκα από τους είκοσι τέσσερις φέρουν opensPillarMonth: true: αυτοί είναι οι 節, που ανοίγουν τον μήνα των στύλων. Οι υπόλοιποι δώδεκα είναι οι 中氣, οι οποίοι διαιρούν τον μήνα στη μέση και καθορίζουν ποιος μήνας θα είναι δίσεκτος.

Ο όρος είναι μια στιγμή, όχι μια ημέρα, και η ημέρα του είναι διαφορετική

Διάβασε το utc, όχι το beijing, αν ο χρήστης σου δεν βρίσκεται στην Κίνα. Η Κίνα και το Χονγκ Κονγκ υπολογίζουν με UTC+8, η Ιαπωνία και η Κορέα με UTC+9, το Βιετνάμ με UTC+7, οπότε μία ώρα από τις είκοσι τέσσερις είναι ένα παράθυρο στο οποίο οι εθνικοί αλμανάκ εκτυπώνουν διαφορετικές ημερολογιακές ημέρες. Κατά μέσο όρο, αυτό συμβαίνει ένας όρος ανά έτος. Το 2026 υπάρχουν δύο: το 雨水 είναι 18 Φεβρουαρίου στο Πεκίνο και 19 Φεβρουαρίου στο Τόκιο, το 芒種 είναι 5 και 6 Ιουνίου. Οι στιγμές μας αναπαράγουν και τις δύο δημοσιεύσεις με ακρίβεια λεπτού.

Γλώσσες

Τα ζώα και τα στοιχεία έχουν μεταφραστεί σε 21 γλώσσες. Πρόσθεσε ?lang= ή "language" στο σώμα, και δίπλα στο αγγλικό token θα εμφανιστεί το πεδίο *Name:

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" } }

Τα αγγλικά πεδία παραμένουν στη θέση τους για πάντα: η τοπικοποίηση προσθέτει, δεν αντικαθιστά.