开发者

一个时刻,七种历法。

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 的人事、薪酬与物流系统。本地库保持免费且功能完整。

目前没有任何线上接入点。若你需要提前使用,可以来信——我们正在招募设计合作伙伴。