celestial-calendar
ESM别名包 @0xf3cd /天体. 它再出口
从根条目开始的所有内容 /date,包括TypeScript声明,并且依赖于完全相同的
主软件包的版本。别名不复制实现,也不包含WebAssembly模块。
本指南描述了当前源代码,包括未发布的更改。使用与您安装的版本相匹配的文档。使用 电流源, 构建主包和别名包 从完整的签出并安装相同版本的两个tarball。
安装和示例
从npm安装到你的应用目录:
npm install celestial-calendar
支持Node 22或更新版本。下面的每个JavaScript块都是一个独立的ES模块 example.mjs 在你的
应用程序目录;运行它 node example.mjs 从那个目录。
今天的农历日期
首先采用固定的UTC+8的公历日期,然后将其转换为农历日期;不要过一个文明的时刻吗
携带 fraction 直接。
import * as celestial from "celestial-calendar";
import { dateToCivilAtOffset } from "celestial-calendar/date";
const eastEight = dateToCivilAtOffset(new Date(), 480);
const { year, month, day } = eastEight;
const gregorian = { year, month, day };
await celestial.init();
console.log("UTC+8 Gregorian date:", gregorian);
console.log("Lunar date:", celestial.lunar.fromGregorian("algo3", gregorian));
Jieqi和UTC日期字段
下面的示例查询立春的UT1时刻,并分别查询当前时钟的UTC民用字段;否
时间尺度转换连接两个输出。的Jieqi momentUt1 既不是UTC也不是UTC+8挂钟。
import * as celestial from "celestial-calendar";
import { dateToCivilUtc } from "celestial-calendar/date";
await celestial.init();
console.log(celestial.jieqi.moment(2026, celestial.Jieqi.LICHUN));
console.log(dateToCivilUtc(new Date()));
与主包的关系
/date 不加载WASM,不需要初始化;它只桥接UTC或固定偏移量的民用字段,
没有UTC/UT1/TT转换。当两个包名解析为相同的主安装时,它们共享导出
引用和初始化状态;这并不保证混合版本或任意版本的重复数据删除
依赖图。有关API契约、月球算法的日期基础和浏览器使用,请参阅
主包指南.
PyPI上同名的包是一个单独的Python发行版。
许可证
该别名的项目创作材料在MIT许可下;看到 LICENSE.
有关依赖项中保留的第三方材料,请参见 @0xf3cd/celestial/THIRD_PARTY_NOTICES.txt
在安装的主包中。该目录属于依赖项,没有绑定在此别名中。