Çin Zodyağı ve Takvim

Yılın hayvanı, geleneğin en bilinen ve genellikle yanlış hesaplanan kısmıdır. BaZi’de yıl 1 Ocak’ta veya Çin Yeni Yılı’nda değil, Güneş’in görünür boylamının 315°‘ye ulaştığı an olan 立春 Lichun ile başlar. 2026’da bu 2026-02-03T20:02:08Z, yani Pekin saatiyle 4 Şubat 04:02’dir. 2 Şubat’ta doğan biri, duvardaki takvim yeni yılı gösterse de önceki hayvana aittir.

Uç Noktalar

Uç Nokta	Kredi	Ne Döndürür
POST /v1/chinese/zodiac/animal	10	Yılın hayvanı, sütun, dal ve gövde elementleri
POST /v1/chinese/zodiac/element	10	Dalın sabit elementi ve gövdenin döngüsel elementi
POST /v1/chinese/zodiac/inner-animal	10	İçsel hayvan: ay dalı
POST /v1/chinese/zodiac/secret-animal	10	Gizli hayvan: saat dalı
POST /v1/chinese/zodiac/compatibility	10	İki hayvanın 三合 ve 六冲’a göre uyumluluğu
POST /v1/chinese/lunar-date	10	Ay tarihi, artık ay, Çin Yeni Yılı
POST /v1/chinese/solar-terms	10	Yılın 24 teriminin tamamı saniye hassasiyetinde

Bir Değil, Üç Hayvan

Dergi burçları tek bir hayvan bilir. Gelenek üç hayvan bilir ve bunlar farklı soruları yanıtlar.

Hayvan	Nereden	Ne Anlama Gelir
Dışsal	yıl dalı	İnsanların seni nasıl gördüğü
İçsel	ay dalı	Motivasyonlar, özel “benlik”
Gizli	saat dalı	En derin katman, genellikle kişinin kendisinden bile gizli

İçsel hayvan, ayın ortasıyla değil, 節’in kesin anlarıyla sınırlıdır, bu nedenle 5 Mayıs ve 6 Mayıs’ta doğanlar farklı hayvanlara sahip olabilir.

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

Yılın İki Elementi

1990 doğumlu biri “metal at”tır ve bu isimde kolayca karıştırılabilecek iki farklı element bulunur.

• Döngüsel göksel gövdeden gelir ve her iki yılda bir değişir: 庚 metaldir.
• Sabit dünya dalına sonsuza dek aittir: 午 ateştir ve at her zaman ateşlidir.

/chinese/zodiac/element, müşteri adına seçim yapmak yerine her ikisini de fixedElement ve cyclingElement olarak ayrı alanlarda döndürür.

Uyumluluk

Değerlendirme, 三合 (üç uyum) ve 六冲 (altı çatışma) üzerine, yani düşünce listesi yerine dalların çemberinin geometrisi üzerine kuruludur.

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

Hayvan uyumluluğu bir katmandır, bir harita değil

Yılın hayvanlarını karşılaştırmak en kaba kesittir: bir kişi hakkında sekiz hiyerogliften sadece birini bilir. Gerçek bir okuma için her ikisinin de /v1/bazi/chart’ını al ve dört sütunun tüm etkileşimlerine bak.

Ay Tarihi

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

Ay, yeni ayı içeren Pekin günüyle başlar. Artık ay, bir öncekinin numarasını tekrar eder ve 中氣 içermez: varoluş nedeni budur, bir yan etki değil.

1929 Öncesi

1929 öncesi takvim, Pekin yerel ortalama zamanına (UTC+7:45:40) göre hesaplanır ve bu bizim varsayımımız değil, tarihi bir temeldir. Yerel gece yarısına yakın dakikalara denk gelen yeni ay, ayı o günün basılı almanakından bir gün sonraya taşıyabilir, çünkü o almanaklar gün hassasiyetinde hesaplanıyordu.

Yirmi Dört Güneş Terimi

Terim, bir tablodaki tarih değil, Güneş’in görünür boylamının 15°‘nin katı olduğu anıdır. Bunu efemerislerden alırız, bu nedenle yanıt, alan içindeki herhangi bir yıl için aynıdır ve birinin tabloyu güncelleyip güncellemediğine bağlı değildir.

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 dizisi yirmi dördünü de taşır; burada ilki gösterilmiştir:

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

Yirmi dörtten on ikisi opensPillarMonth: true taşır: bunlar sütun ayını açan 節’lerdir. Geri kalan on ikisi ise 中氣’dir, bunlar ayı ikiye böler ve hangi ayın artık ay olacağını belirler.

Terim bir andır, bir gün değil, ve günü farklıdır

Kullanıcın Çin’de değilse beijing yerine utc’yi oku. Çin ve Hong Kong UTC+8’e göre, Japonya ve Kore UTC+9’a göre, Vietnam UTC+7’ye göre hesaplar, bu nedenle yirmi dört saatten biri, ulusal almanakların farklı takvim günleri bastığı bir penceredir. Ortalama olarak yılda bir terimdir. 2026’da iki tane var: 雨水 Pekin’de 18 Şubat, Tokyo’da 19 Şubat; 芒種 5 ve 6 Haziran. Anlarımız her iki yayını da dakikasına kadar doğru bir şekilde yeniden üretir.

Diller

Hayvanlar ve elementler 21 dile çevrilmiştir. ?lang= veya gövdeye "language" ekle, İngilizce token’ın yanında *Name alanı görünecektir:

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

İngilizce alanlar kalıcı olarak yerinde kalır: yerelleşme ekler, değiştirmez.