Cung hoàng đạo Trung Quốc và lịch

Con giáp năm là phần nổi tiếng nhất của truyền thống và thường được tính sai. Năm trong BaZi không bắt đầu vào ngày 1 tháng 1 hay từ Tết Nguyên Đán Trung Quốc, mà từ Lập Xuân Lichun, khoảnh khắc khi kinh độ biểu kiến của Mặt Trời đạt đến 315°. Năm 2026, điều này là 2026-02-03T20:02:08Z, tức là 4 tháng 2 lúc 04:02 theo giờ Bắc Kinh. Người sinh ngày 2 tháng 2 thuộc con giáp trước đó, dù lịch trên tường đã chỉ ra năm mới.

Endpoints

Endpoint	Credits	Trả về
POST /v1/chinese/zodiac/animal	10	Con giáp năm, cột, yếu tố của nhánh và trụ
POST /v1/chinese/zodiac/element	10	Yếu tố cố định của nhánh và yếu tố tuần hoàn của trụ
POST /v1/chinese/zodiac/inner-animal	10	Con giáp nội tại: nhánh tháng
POST /v1/chinese/zodiac/secret-animal	10	Con giáp bí mật: nhánh giờ
POST /v1/chinese/zodiac/compatibility	10	Sự tương thích giữa hai con giáp theo Tam Hợp và Lục Xung
POST /v1/chinese/lunar-date	10	Ngày âm, tháng nhuận, Tết Nguyên Đán Trung Quốc
POST /v1/chinese/solar-terms	10	Tất cả 24 tiết khí trong năm với độ chính xác đến giây

Ba con giáp, không phải một

Tử vi trong tạp chí chỉ biết một con giáp. Truyền thống biết ba, và chúng trả lời những câu hỏi khác nhau.

Con giáp	Nguồn gốc	Ý nghĩa
Ngoại	nhánh năm	Cách người khác nhìn nhận bạn
Nội	nhánh tháng	Động lực, “bản ngã” riêng tư
Bí mật	nhánh giờ	Lớp sâu nhất, thường ẩn giấu ngay cả với chính bạn

Con giáp nội tại bị giới hạn bởi các thời điểm chính xác của Tiết, không phải giữa tháng, vì vậy sinh ngày 5 tháng 5 và 6 tháng 5 có thể cho ra những con giáp khác nhau.

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

Hai yếu tố năm

Người sinh năm 1990 là “ngựa kim”, và trong cái tên này có hai yếu tố khác nhau dễ gây nhầm lẫn.

• Tuần hoàn đến từ thiên trụ và thay đổi mỗi hai năm: Canh là kim.
• Cố định thuộc về địa nhánh mãi mãi: Vũ là hỏa, và ngựa luôn là hỏa.

/chinese/zodiac/element trả về cả hai như các trường riêng biệt, fixedElement và cyclingElement, thay vì để khách hàng tự chọn.

Sự tương thích

Đánh giá được xây dựng dựa trên Tam Hợp (ba sự hài hòa) và Lục Xung (sáu sự xung đột), tức là hình học của vòng tròn nhánh, chứ không phải danh sách ý kiến.

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

Sự tương thích giữa các con giáp chỉ là một lớp, không phải bản đồ

So sánh con giáp năm là cách thô sơ nhất: nó chỉ biết về bạn đúng một trong tám ký tự. Để có sự đọc thực sự, hãy lấy /v1/bazi/chart của cả hai và xem xét tương tác của cả bốn cột.

Ngày âm

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

Tháng bắt đầu từ ngày Bắc Kinh chứa trăng non. Tháng nhuận lặp lại số của tháng trước và không chứa Trung khí: đây là lý do tồn tại của nó, không phải tác dụng phụ.

Trước năm 1929

Lịch trước năm 1929 được tính theo giờ Bắc Kinh địa phương trung bình (UTC+7:45:40), và đây là cơ sở lịch sử, không phải quy ước của chúng tôi. Trăng non rơi vào phút gần nửa đêm địa phương có thể đặt tháng vào một ngày xa hơn so với lịch in của ngày đó, vì những cái đó được tính với độ chính xác đến ngày.

Hai mươi bốn tiết khí

Tiết khí không phải là ngày trong bảng, mà là khoảnh khắc khi kinh độ biểu kiến của Mặt Trời trở thành bội số của 15°. Chúng tôi lấy nó từ thiên văn học, vì vậy câu trả lời giống nhau cho bất kỳ năm nào trong phạm vi và không phụ thuộc vào việc ai đó đã cập nhật bảng hay chưa.

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

Mảng terms chứa tất cả hai mươi bốn; ở đây được hiển thị cái đầu tiên:

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

Mười hai trong số hai mươi bốn mang opensPillarMonth: true: đây là Tiết, mở ra tháng trụ. Mười hai còn lại là Trung khí, chúng chia tháng làm đôi và xác định tháng nào sẽ là tháng nhuận.

Tiết khí là khoảnh khắc, không phải ngày, và ngày của nó khác nhau

Đọc utc, không phải beijing, nếu người dùng của bạn không ở Trung Quốc. Trung Quốc và Hồng Kông tính theo UTC+8, Nhật Bản và Hàn Quốc theo UTC+9, Việt Nam theo UTC+7, vì vậy một trong hai mươi bốn giờ là cửa sổ mà các lịch quốc gia in ra các ngày khác nhau. Trung bình là một tiết khí mỗi năm. Năm 2026 có hai: Vũ Thủy là 18 tháng 2 ở Bắc Kinh và 19 tháng 2 ở Tokyo, Mang Chủng là 5 và 6 tháng 6. Những khoảnh khắc của chúng tôi tái tạo cả hai ấn phẩm với độ chính xác đến phút.

Ngôn ngữ

Các con giáp và yếu tố được dịch sang 21 ngôn ngữ. Thêm ?lang= hoặc "language" vào phần thân, và trường *Name sẽ xuất hiện bên cạnh token tiếng Anh:

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

Các trường tiếng Anh vẫn ở lại mãi mãi: bản địa hóa thêm vào, chứ không thay thế.