文檔
快速開始
五行代碼，從一個 UTC 時刻得到七種同步曆法。
1. 安裝
npm install @unified-calendar/core2. 解碼
導入解碼器並傳入 ISO 8601 的 UTC 字符串。返回值中每種曆法各佔一個字段，另含規範的 UCP 字符串。
const { decodeUCP } = require('@unified-calendar/core');
const data = decodeUCP("2026-03-21T14:30:00Z");返回內容
{
ucpString: 'UE-12026 :: 03.21-04 :: 02.03.03 H10.02 (U) [Jia-Wu] T14:30:00Z',
gregorian: 'Year 2026, Month 3, Day 21',
xia: 'Year 丙午, Month 辛卯, Day Jia-Wu (Solar Term: 春分)',
chinese: 'Year 4724, M: 2, D: 3',
hindu: 'Amanta Month 1, Tithi 3, Nakshatra 3',
buddhist: 'Year BE 2569, Lunar Month 2, Day 3',
saka: 'Year Saka 1947, Month 12, Day 30',
islamic: 'Year 1447 AH, Shawwal (M: 10), Day 2'
}3. 讀取字段
console.log(data.saka);
//> Year Saka 1947, Month 12, Day 30注意事項
- 包為 CommonJS，Node.js 中用 require()，ESM 環境可加一層包裝後 import。
- 所有計算都以 UTC 做地心計算。本地出生時間需先換算再調用 decodeUCP()。
- astronomy-engine 與 lunar-javascript 會作為依賴自動安裝。
- 庫為 MIT 許可。託管 API 屬獨立服務，尚未上線。