开发者
一个时刻,七种历法。
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 的人事、薪酬与物流系统。本地库保持免费且功能完整。