الأبراج الصينية والتقويم

حيوان العام هو الجزء الأكثر شهرة في التقليد وغالبًا ما يتم حسابه بشكل خاطئ. لا يبدأ العام في BaZi في 1 يناير ولا مع رأس السنة الصينية الجديدة، بل مع 立春 Lichun، اللحظة التي يصل فيها خط الطول الظاهري للشمس إلى 315 درجة. في عام 2026، سيكون ذلك 2026-02-03T20:02:08Z، أي 4 فبراير الساعة 04:02 بتوقيت بكين. المولود في 2 فبراير ينتمي إلى الحيوان السابق، على الرغم من أن التقويم على الحائط يظهر بالفعل العام الجديد.

نقاط النهاية

نقطة النهاية	الاعتمادات	ما يعيده
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	جميع المصطلحات الأربعة والعشرين للعام بدقة تصل إلى الثانية

ثلاثة حيوانات، وليس واحدًا

تعرف الأبراج في المجلات حيوانًا واحدًا. التقليد يعرف ثلاثة، وهي تجيب على أسئلة مختلفة.

الحيوان	من أين	ماذا يعني
الخارجي	فرع العام	كيف يراك الآخرون
الداخلي	فرع الشهر	الدوافع، الذات الخاصة
السري	فرع الساعة	الطبقة الأعمق، غالبًا ما تكون مخفية عن الشخص نفسه

يقتصر الحيوان الداخلي على اللحظات الدقيقة لـ 節، وليس منتصف الشهر، لذلك قد يؤدي الميلاد في 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" في الجسم، وسيظهر حقل *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" } }

تبقى الحقول الإنجليزية في مكانها دائمًا: التوطين يضيف، ولا يستبدل.