# Konvensi BaZi

Masukkan satu momen kelahiran ke dalam dua kalkulator BaZi dan kamu akan mendapatkan dua bagan yang berbeda. Terkadang dengan **day master** yang berbeda, yaitu karakter yang menjadi dasar seluruh pembacaan. Ini bukan kesalahan salah satunya. Di balik setiap bagan terdapat empat konvensi, masing-masing memiliki sejarahnya sendiri, dan kalkulator menerapkannya secara diam-diam dan berbeda.

Di bawah ini adalah jawaban kami untuk masing-masing dari empat konvensi tersebut. Konvensi-konvensi ini diumumkan dalam bidang `disclaimer` dari setiap respons, sehingga perubahannya merupakan breaking change, bukan refactoring.

## 1. Di mana tahun dimulai: Lichun atau Tahun Baru Imlek

**Jawaban kami: Lichun (立春), momen yang tepat.**

BaZi adalah sistem surya di dalam kalender lunisolar. Pilar-pilar bulan terikat pada dua puluh empat istilah surya, yaitu posisi Matahari, bukan fase Bulan, dan tahun mengikuti logika yang sama: ia kembali pada Lichun, sekitar 4 Februari. Tahun Baru Imlek adalah hal yang berbeda: bulan baru pertama dalam tahun lunar, yang bergerak dari akhir Januari hingga akhir Februari.

Kelahiran dalam rentang waktu tersebut termasuk dalam satu hewan menurut satu aturan dan hewan lain menurut aturan kedua. Kedua aturan tersebut valid. Kami mengambil Lichun, dan momennya diambil dari ephemeris, bukan dari tanggal "4 Februari".

## 2. Di mana hari dimulai: 23:00 atau tengah malam

**Jawaban kami: 23:00 menurut waktu tempat kelahiran.**

Hari tradisional adalah dua belas jam ganda, dan yang pertama, jam 子, berlangsung dari 23:00 hingga 01:00. Semua jam lainnya masuk dalam satu hari kalender. Jam 子 berada di atas tengah malam, dan dari fakta struktural tunggal inilah seluruh perdebatan muncul: jika jam 子 membuka hari, kelahiran pada pukul 23:30 sudah termasuk hari berikutnya.

Ini adalah sumbu yang mengubah day master. Dengan menggeser pilar hari, kamu tidak memperjelas bagan, kamu menggantinya.

Oleh karena itu, pembacaan alternatif tidak pernah disembunyikan. Setiap rute bagan menerima `dayBoundary: "23:00" | "midnight"` (default 23:00), dan kelahiran pada jam 23:00 dikembalikan dengan `alternateDay`: pilar hari dan day master menurut aturan yang tidak kamu pilih. Pilar jam sama untuk keduanya, karena jam 子 yang terlambat mengambil batang dari hari berikutnya dalam kasus apa pun. Dari 00:00 hingga 00:59, semua aliran sepakat mengenai hari, jadi tidak ada alternatif di sana.

## 3. Apakah jam dikoreksi berdasarkan garis bujur lokasi

**Jawaban kami: berdasarkan permintaan, dan hanya untuk hari dan jam.**

Sebagian besar sejarah sistem ini, pertanyaan tersebut tidak mungkin muncul: waktu lokal adalah waktu matahari. Zona waktu adalah penemuan era kereta api, dan begitu suatu negara hidup dengan satu jam, jam tersebut hanya bertepatan dengan Matahari di satu meridian. Tiongkok adalah kasus ekstrem: satu zona untuk enam puluh derajat garis bujur, sehingga kelahiran di Kashgar berjarak hampir tiga jam dari tengah hari matahari menurut waktu Beijing.

```bash frame="terminal"
curl -X POST https://api.astroway.info/v1/chinese/true-solar-time \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "date": "1995-06-15", "time": "09:20:00", "timezoneOffset": 8, "longitude": 75.9 }'
```

**Koreksi hanya berlaku untuk hari dan jam, dan berhenti di situ:**
Lichun dan dua belas 節 adalah momen pada jam dunia: Matahari mencapai 315° sekali, dan setiap kelahiran di Bumi terjadi sebelum atau sesudah momen ini. Pembacaan jam matahari menunjukkan di mana pengamat berdiri, bukan kapan momen itu tiba. Oleh karena itu, memberikan jam yang dikoreksi dalam batas tahun dan bulan berarti mengajukan pertanyaan yang salah kepada mereka.

Harga kesalahannya spesifik: kelahiran di Beijing pada pukul 23:00 tanggal 4 Februari 1988, yaitu **tujuh belas menit setelah Lichun**, dikoreksi kembali menjadi 22:31 dan akan mendapatkan tahun matahari sebelumnya, bulan sebelumnya, day master yang berbeda, dan set sepuluh dewa yang berbeda. Kami membuat kesalahan ini dan memperbaikinya sebelum rilis.

## 4. Apa yang harus dilakukan dengan waktu musim panas

**Jawaban kami: hanya pemanggil yang tahu.**

Bidang `timezoneOffset` adalah offset di mana **jam sebenarnya berjalan** pada saat kelahiran. Kelahiran di Beijing tahun 1988 mengikuti UTC+9, bukan +8, karena Tiongkok menerapkan waktu musim panas dari tahun 1986 hingga 1991. Tidak ada aritmatika di pihak kami yang dapat memulihkan ini dari tanggal itu sendiri, jadi kami tidak menebak.

## 5. Apa yang dikatakan respons tentang dirinya sendiri

Setiap rute bagan, `/v1/bazi/chart`, rute analisis, `day-master`, `ten-gods`, `luck-pillars`, `yearly`, dan `monthly`, mengembalikan objek `conventions`: batas tahun dan bulan (`lichun`, `jie`), `dayBoundary` yang digunakan, apakah waktu matahari sejati diterapkan dan berapa menit, zona waktu dengan offset dan apakah waktu musim panas berlaku, serta tanggal Tahun Baru Imlek dalam tahun Gregorian kelahiran. `timezone.assumed: true` berarti baik zona waktu maupun offset tidak dikirim, dan batas-batas dibaca menurut waktu Beijing.

Tanggal **tanpa waktu** dibaca pada tengah hari. Ketika Lichun atau 節 jatuh pada hari lokal ini, respons bergantung pada jam, sehingga respons menambahkan `boundaryInDay`: jenis batas, momen lokal, sisi mana tengah hari jatuh, dan pilar tahun serta bulan dari kedua sisi.

## Momen batas itu sendiri, 1900-2100

Setiap pilar tahun dan bulan bergantung pada momen Lichun dan sebelas 節 lainnya, sehingga momen-momen ini telah diverifikasi dengan dua sumber yang tidak memiliki kode yang sama dengan kami. Dua belas istilah yang membuka bulan, untuk setiap tahun dari 1900 hingga 2100, yaitu 2.412 momen, ditemukan secara independen melalui JPL Horizons (DE441) dengan akurasi hingga seperseratus detik. Momen kami bertepatan dengan mereka dalam batas 4 detik dari tahun 1950 hingga 2025 dan dalam batas 8 detik hingga tahun 1900. Setelah tahun 2025, kedua belah pihak harus memprediksi bagaimana rotasi Bumi akan bergeser, dan prediksi tersebut perlahan-lahan menyimpang, hingga 21 detik pada tahun 2100.

Tanggal-tanggal istilah yang sama menurut UTC+8 telah diverifikasi dengan tabel Hong Kong Observatory untuk tahun 1901-2100. Sebanyak 2.398 dari 2.400 bertepatan. Dua yang berbeda, Daxue 1917 dan Bailu 1927, jatuh beberapa menit setelah tengah malam, dan Horizons mendukung tanggal kami di sana.

## Uji coba pada dataset eksternal

Jade Almanac telah menerbitkan perbandingan delapan implementasi pada tiga belas probe, yang secara khusus dibangun di atas empat sumbu ini, di bawah lisensi CC0: [jadealmanac.com/bazi-calculator/conventions](https://jadealmanac.com/bazi-calculator/conventions). Dataset ini mengukur **konvensi, bukan kebenaran**, dan menyatakan hal itu sendiri.

Kami menjalankan `POST /v1/bazi/four-pillars` kami pada ketiga belas probe tersebut. Hasilnya dapat direproduksi dengan perintah di repositori dan telah dicatat dalam pengujian.

| Probe | Apa yang diisolasi | Jawaban kami |
|---|---|---|
| `1985-02-10` | batas tahun | `Yi-Chou`, karena Lichun sudah lewat |
| `1990-06-15 23:30` | transisi hari | hari `Ren-Zi`: hari sudah berganti |
| `1988-02-04 23:00` | Lichun dan 23:00 bersamaan | `Wu-Chen Jia-Yin Geng-Yin Bing-Zi` |
| `1995-06-15 09:20` Kashgar | waktu matahari sejati | tanpa koreksi `Yi-Si`, dengan koreksi `Gui-Mao` |

Satu catatan jujur tentang siapa yang kami cocokkan. Penerbit dataset menulis bahwa engine-nya didasarkan pada `tyme4ts`, dan `lunar-javascript` dari penulis yang sama. Jadi, tiga baris teratas tabel ini adalah satu garis, bukan tiga suara independen. Di antara yang independen darinya, `feng-shui-institute.org` memiliki cakupan penuh, dan setelah menerapkan waktu matahari sejati, kami mereproduksi jawabannya pada ketiga probe di mana ia menerapkan koreksi.

Satu-satunya perbedaan nyata kami dengan aliran tersebut adalah: transisi hari pada pukul 23:00.
