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

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

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

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

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

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

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

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

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

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

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

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

```bash
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](/chinese/ziwei/).

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

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

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

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

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

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

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

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