Китайська метафізика: часті питання

Чому ваш калькулятор дає інші стовпи, ніж інший?

Майже завжди причина одна з чотирьох, і жодна з них не помилка. Це вибір школи, який більшість калькуляторів робить мовчки. Наші відповіді і прогін по зовнішньому датасету на сторінці конвенцій.

Вісь	Наша відповідь
Межа року	立春 Lichun, точна мить з ефемерид
Межа доби	23:00, ранній 子時 належить наступному дню
Істинний сонячний час	вимкнено за замовчуванням, вмикається прапорцем
Літній час	розв’язується timezoneOffset, який ви надсилаєте

Рік починається з китайського Нового року чи з Lichun?

З Lichun, і ці дві дати розходяться щороку на два-три тижні. Китайський Новий рік це початок місячного року і свята; стовпи будуються на сонячному році, який відкриває Lichun. Народжений 10 лютого 2026 року вже належить Коню за стовпами, хоча Новий рік був 17 лютого.

/v1/chinese/lunar-date віддає chineseNewYear окремим полем саме тому, що це інша величина, а не синонім.

Що надсилати, якщо час народження невідомий?

Не надсилайте time взагалі. Три стовпи з чотирьох порахуються, а годинний просто не з’явиться. Це чесніше, ніж підставити полудень: підставлений час дає годинний стовп, який виглядає як факт і ним не є, і тягне за собою 神煞, які від нього залежать.

Що зміниться без години:

• годинний стовп відсутній
• таємна тварина відсутня
• баланс стихій рахується по шести ієрогліфах замість восьми
• сила денного господаря зсувається, бо зникає чверть карти

Коли вмикати trueSolarTime?

Коли місце народження далеке від меридіана свого часового поясу. Китай від Кашгара до Харбіна живе за одним UTC+8, і в Сіньцзяні розбіжність доходить до трьох годин, тобто до півтори стражі. Прапорець зсуває день і годину, і навмисно не зсуває рік і місяць: Lichun це світова мить, і показання сонячного годинника до неї не має стосунку.

curl -X POST https://api.astroway.info/v1/chinese/true-solar-time \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-05-15","time":"14:30:00","timezoneOffset":8,"longitude":87.6}'

Чому у вас 藏干 в іншому порядку, ніж у книжці?

Порядок у нашому списку йде за днями 人元司令, тобто за тим, у якому порядку приховані стовбури керують місяцем. Роль (principal, middle, residual) стоїть окремим полем і не залежить від позиції. На чотирьох гілках-сховищах 丑辰未戌 середня роль належить стихії, яку гілка зберігає, а не другому елементу списку. Це та точка, де публічні реалізації розходяться найчастіше.

Ви рахуєте Zi Wei Dou Shu?

Так. POST /v1/ziwei/chart будує карту повністю: дворці Життя і Тіла з місячного місяця і стражі, 五行局 зі стовпа дворця Життя, 紫微 за правилом ділення з позикою, решту тринадцять головних зірок, шість щасливих і шість лихих, тридцять одну малу, дванадцять стадій, цикли 博士, 將前 і 歲前, десятирічні межі і річну, з 四化 позначеними прямо на зірках.

Одинадцять маршрутів /ziwei/* лишаються довідковими таблицями дворців і зірок. Вони несуть поле computed: false, коштують половину тарифу і віддають те саме будь-якій даті: це словник, і так і написано. /ziwei/full-chart депрекований до 2027-11-26 на користь /ziwei/chart.

Подробиці і перевірка: Zi Wei Dou Shu.

Чим ви кращі за безкоштовну бібліотеку?

Нічим, якщо вам треба тільки стовпи. lunar-typescript під MIT рахує їх у вашому процесі, офлайн, без обмежень частоти, і ми не радимо платити за те, що можна не купувати.

Різниця починається далі: 神煞, взаємодії гілок 刑冲合害, оцінка сили денного господаря, істинний сонячний час, летючі зірки за сидінням і фасадом, число Гуа, вибір дати Тун Шу. І 21 мова на все це. Плюс те, за що зазвичай платять насправді: одна конвенція для команди, у якої PHP на сайті, JavaScript у застосунку і Python у кронах.

Чому назви тварин англійською, а стовбури піньїнем?

Тварини і стихії мають усталені назви в кожній мові, тому вони перекладені: 午 це Caballo іспанською і ウマ японською. Стовбури, гілки, 納音 і назви зірок усталених назв не мають, і їхнє міжнародне ім’я це піньїнь поруч з ієрогліфом. Вигадати чеське слово для 甲 було б гірше, ніж лишити 甲. Те саме правило діє в блоці Human Design.

Який діапазон дат ви приймаєте?

Роки з 2 по 2899. Календар виведений з ефемерид, тому працює далеко за межами друкованих таблиць, але не безмежно: вихід за домен повертає 400 з назвою поля, а не 500.

{ "ok": false, "error": { "code": "INVALID_INPUT",
  "message": "Validation failed: year: Too big: expected number to be <=2899" } }