Tyme

Tyme是一个非常强大的日历工具库，可以看作 Lunar 的升级版，拥有更优的设计和扩展性，支持公历、农历、藏历、星座、干支、生肖、节气、法定假日等。

示例

// install
npm init -y
npm i typescript -D
npm i ts-node -D
npm i tyme4ts

// test.ts
import {SolarDay} from 'tyme4ts';

const solar: SolarDay = SolarDay.fromYmd(1986, 5, 29);

// 1986年5月29日
console.log(solar.toString());

// 农历丙寅年四月廿一
console.log(solar.getLunarDay().toString());

// 第十七饶迥火虎年四月廿一
console.log(solar.getRabByungDay().toString());

// run
ts-node test.ts

文档

请移步至 https://6tail.cn/tyme.html

Star History

致谢

1. 感谢许剑伟老师分享的寿星天文历，本项目节气算法引自 https://github.com/sxwnl/sxwnl
2. 感谢stonelf，本项目藏历数据引自 https://github.com/stonelf/zangli

Changelog

[1.0.4] - 2024-02-20

1. 童限计算支持自定义，增加元亨利贞的起运算法。
2. 增加八字转公历时刻。

[1.0.5] - 2024-03-28

1. 新增：公历周获取位于当年的索引。
2. 新增：公历日获取公历周。
3. 修复：公历半年、公历季度、公历时刻推移的错误。

[1.0.6] - 2024-06-06

1. 新增：节气第几天。
2. 优化：兼容鸿蒙。

[1.0.7] - 2024-06-22

1. 优化：性能。
2. 新增：六曜。
3. 新增：入梅出梅。
4. 新增：获取农历日当天的时辰列表。

[1.1.0] - 2024-07-09

1. 注意：此版本更改了getYear()、getMonth()、getDay()的返回类型，非兼容性更新。
2. 新增：吉神宜趋、凶神宜忌。
3. 新增：每日宜忌、时辰宜忌。
4. 修复：农历日获取时辰列表遇闰月报错的问题。

[1.1.1] - 2024-07-27

1. 修复：获取当年第几周报错的问题。
2. 新增：五行和方位互转。
3. 新增：天干五合、地支六合、地支六害。
4. 优化：性能。

[1.1.2] - 2024-08-19

1. 优化：十神计算逻辑。
2. 修复：获取起运时间报错的问题。

[1.1.3] - 2024-09-27

1. 优化：代码。
2. 修复：吉神宜趋、凶神宜忌错误。

[1.1.4] - 2024-10-04

1. 新增：Lunar的2种起运流派。
2. 新增：支持八字晚子时日柱算当天。

[1.1.5] - 2024-10-14

1. 新增：八字转公历时刻支持晚子时算当天。
2. 新增：小六壬。

[1.1.6] - 2024-11-13

1. 新增：2025年法定假日。

[1.1.7] - 2024-12-02

1. 优化：解决强制类型转换的警告。

[1.1.8] - 2024-12-06

1. 新增：人元司令分野。
2. 修复：立春比正月初一早导致大小运错误的问题。

[1.1.9] - 2025-01-10

1. 优化：实例初始化参数兼容字符串类型。

[1.2.0] - 2025-01-16

1. 优化：解决arkts警告。

[1.2.1] - 2025-01-29

1. 新增：灶马头 KitchenGodSteed。
2. 修复：月九星计算错误的问题。
3. 修复：九星错别字。

[1.2.2] - 2025-03-01

1. 修复：宜忌错别字。
2. 优化：简化代码。
3. 优化：流年计算逻辑。
4. 优化：优化节气推移。

[1.3.0] - 2025-04-09

1. 新增：干支年、干支月、干支日、干支时辰。
2. 新增：童限的所属大运、开始年龄、结束年龄。
3. 废弃：八字的建除十二值神（建议从干支日中获取）。
4. 废弃：农历日的当天年干支、当天月干支（建议从干支日中获取）。
5. 废弃：农历时辰的当时年干支、当时月干支、当时日干支（建议从干支时辰中获取）。
6. 废弃：童限的结束农历年（建议取结束干支年）。
7. 废弃：大运的开始农历年、结束农历年（建议取开始干支年、结束干支年）。
8. 废弃：小运的农历年（建议取干支年）。
9. 修复：八字身宫计算错误的问题。

[1.3.1] - 2025-04-29

1. 新增：藏历。
2. 修复：干支月获取干支日列表为空的问题。

[1.3.3] - 2025-05-08

1. 修复：法定假日和农历传统节日的错误。