文档
快速开始
五行代码，从一个 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 属独立服务，尚未上线。