開發者
一個時刻，七種曆法。
UCP 是一套開放標準，讓各文化曆法保持同步而不產生置閏漂移。參考實現是一個 Node.js 庫，MIT 許可，永久免費。
安裝
內核以 Node.js 包分發，兩個依賴 astronomy-engine 與 lunar-javascript 會自動安裝。
npm install @unified-calendar/core解碼一個時刻
decodeUCP() 接受 ISO 8601 的 UTC 字符串，返回鎖定到該時刻的全部曆法。
const { decodeUCP } = require('@unified-calendar/core');
// One UTC instant, every calendar system.
const data = decodeUCP("2026-03-21T14:30:00Z");
console.log(data.xia);
//> Year 丙午, Month 辛卯, Day Jia-Wu (Solar Term: 春分)返回內容
{
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'
}七種曆法
以下每種曆法都由同一個天文時刻推導而來，而不是靠偏移量查表。
- 公曆民用標準
- 夏曆節氣與干支
- 中國農曆陰陽合曆
- 印度陰陽曆吠陀 · Lahiri 歲差
- 佛曆民用紀元
- 塞迦歷迴歸太陽曆
- 回曆Umm al-Qura
通書生成器
包內附帶命令行工具，可輸出整年的同步數據——適合測試、研究與印製通書。
文檔
託管 API
面向全球節假日數據與天文事件的託管服務正在開發中，目標客戶是需要 SLA 的人事、薪酬與物流系統。本地庫保持免費且功能完整。