Zodiak Cina dan Kalender

Animal tahun adalah bagian paling terkenal dari tradisi dan paling sering dihitung salah. Tahun dalam BaZi tidak dimulai pada 1 Januari dan tidak pada Tahun Baru Cina, melainkan dengan 立春 Lichun, momen ketika panjang bujur matahari yang terlihat mencapai 315°. Pada tahun 2026 itu 2026-02-03T20:02:08Z, yaitu 4 Februari pukul 04:02 waktu Beijing. yang lahir pada 2 Februari termasuk ke hewan sebelumnya, meskipun kalender di dinding sudah menunjukkan tahun baru.

Endpoint

Endpoint	Kredit	Apa yang dikembalikan
POST /v1/chinese/zodiac/animal	10	Animal tahun, batang, elemen cabang dan batang
POST /v1/chinese/zodiac/element	10	Elemen tetap cabang dan elemen siklik batang
POST /v1/chinese/zodiac/inner-animal	10	Hewan dalam: cabang bulan
POST /v1/chinese/zodiac/secret-animal	10	Hewan rahasia: cabang jam
POST /v1/chinese/zodiac/compatibility	10	Kecocokan dua hewan berdasarkan 三合 dan 六冲
POST /v1/chinese/lunar-date	10	Tanggal lunar, bulan kabisat, Tahun Baru Cina
POST /v1/chinese/solar-terms	10	Semua 24 istilah tahun dengan ketelitian hingga detik

Tiga hewan, bukan satu

Horoskop di majalah hanya mengetahui satu hewan. Tradisi mengetahui tiga, dan mereka menjawab pertanyaan yang berbeda.

Hewan	Dari mana	Apa artinya
Eksternal	cabang tahun	Bagaimana orang lain melihat orang tersebut
Internal	cabang bulan	Motivasi, “aku” pribadi
Rahasia	cabang jam	Lapisan terdalam, sering tersembunyi dari orang itu sendiri

Hewan internal dibatasi oleh momen tepat 節, bukan pertengahan bulan, sehingga kelahiran 5 Mei dan 6 Mei dapat menghasilkan hewan yang berbeda.

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

Dua elemen tahun

Yang lahir pada tahun 1990 adalah “kuda logam”, dan dalam nama itu ada dua elemen berbeda yang mudah tertukar.

• Siklik berasal dari batang langit dan berubah setiap dua tahun: 庚 adalah logam.
• Tetap milik cabang bumi selamanya: 午 adalah api, dan kuda selalu berapi.

/chinese/zodiac/element mengembalikan keduanya sebagai bidang terpisah, fixedElement dan cyclingElement, alih-alih meminta klien memilih.

Kecocokan

Penilaian dibangun atas 三合 (tiga harmoni) dan 六冲 (enam tabrakan), yaitu pada geometri lingkaran cabang, bukan pada daftar pendapat.

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

Kecocokan hewan adalah satu lapisan, bukan peta

Membandingkan hewan tahun adalah pemotongan paling kasar: ia hanya mengetahui satu karakter dari delapan tentang orang. Untuk pembacaan yang sebenarnya, ambil /v1/bazi/chart keduanya dan lihat interaksi keempat batang.

Tanggal lunar

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

Bulan dimulai dari hari Beijing yang mengandung Xiaohan. Bulan kabisat mengulangi nomor bulan sebelumnya dan tidak mengandung 中氣: itu adalah alasan keberadaannya, bukan efek sampingan.

Sebelum 1929

Kalender sebelum tahun 1929 dihitung dengan waktu rata-rata lokal Beijing (UTC+7:45:40), dan itu merupakan dasar historis, bukan konvensi kami. Xiaohan yang jatuh pada menit-menit dekat utara lokal dapat menempatkan bulan satu hari lebih jauh dari almanak cetak pada hari itu, karena mereka dihitung dengan ketelitian hingga hari.

Dua puluh empat istilah matahari

Istilah bukan tanggal dari tabel, melainkan momen ketika panjang bujur matahari yang terlihat menjadi kelipatan 15°. Kami mengambilnya dari efemeris, sehingga jawabannya sama untuk tahun apa pun dalam domain dan tidak tergantung pada apakah seseorang memperbarui tabel.

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

Array terms berisi semua dua puluh empat; berikut contoh pertama:

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

Dua belas dari dua puluh empat memiliki opensPillarMonth: true: itu adalah 節, yang membuka bulan batang. Dua belas sisanya adalah 中氣, mereka membagi bulan menjadi dua dan menentukan bulan mana yang akan menjadi kabisat.

Istilah adalah momen, bukan hari, dan harinya berbeda

Baca utc, bukan beijing, jika penggunamu tidak berada di Cina. Cina dan Hong Kong menghitung dengan UTC+8, Jepang dan Korea dengan UTC+9, Vietnam dengan UTC+7, jadi satu jam dari dua puluh empat adalah jendela di mana almanak nasional mencetak hari kalender yang berbeda. Rata-rata ini satu istilah per tahun. Pada 2026 ada dua: 雨水 adalah 18 Februari di Beijing dan 19 Februari di Tokyo, 芒種 adalah 5 dan 6 Juni. Momen kami mereproduksi kedua publikasi dengan ketelitian hingga menit.

Bahasa

Hewan dan elemen diterjemahkan ke dalam 21 bahasa. Tambahkan ?lang= atau "language" dalam body, dan di samping token bahasa Inggris akan muncul bidang *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" } }

Bidang bahasa Inggris tetap ada selamanya: lokalisasi menambah, bukan mengganti.