# time.almanac 库模块帮助文档
民俗展示
## 范围与约定
- 纯 aardio 黄历内容层，不需要 JavaScript、.NET 或网络；可另配 time.lunar 展示农历日期。
- 支持公历 1901-01-01 至 2100-12-31。输入为北京时间的公历墙钟时间，不自动换算时区或真太阳时。
- 日宜忌与日神煞按节气月取值，交节当天整日换月；日干支在 0 点换日。
- 时辰宜忌在 23 点按次日日干支查表。getHours 按公历日返回 13 段，早子与晚子分列。
- yi/ji 是独立字符串数组，空数组保持为空，不自行填成“诸事不宜”。
- isLucky 仅指十二值神的黄道/黑道分类，不是宜忌综合评分。
- 词条、神煞与彭祖百忌来自民俗资料，彼此可能相矛盾，请勿用于医疗或现实决策。
[民俗黄历](https://www.aardio.com/zh-cn/docs/library/time/almanac/)
## time 成员列表 #
### time.almanac() #
[返回对象:timeAlmanacDayObject](#timeAlmanacDayObject)
### time.almanac(date) #
创建日黄历快照。参数为公历 time 对象、日期字符串或时间戳；省略为今天。
[返回对象:timeAlmanacDayObject](#timeAlmanacDayObject)
## time.almanac 成员列表 #
民俗黄历：宜忌、神煞与时辰信息。纯 aardio，离线可用。
### time.almanac.getDay(date) #
获取日黄历，忽略时分秒。失败返回 null,err。
[返回对象:timeAlmanacDayObject](#timeAlmanacDayObject)
### time.almanac.getHour(date) #
获取指定时刻的时辰宜忌；23点按次日日干支查表。失败返回 null,err。
[返回对象:timeAlmanacHourObject](#timeAlmanacHourObject)
### time.almanac.getHours(date) #
获取公历当天全部13段时辰（早子与晚子分列），返回数组。失败返回 null,err。
### time.almanac.getSource() #
获取黄历数据来源、版本、哈希等。
### time.almanac.nowBeijing() #
返回当前北京时间，不依赖电脑的时区设置。
## timeAlmanacDayObject 成员列表 #
### timeAlmanacDayObject.badGods #
凶煞宜忌：字符串数组。
### timeAlmanacDayObject.clash #
日冲生肖，如马。
### timeAlmanacDayObject.date #
公历日期字符串。
### timeAlmanacDayObject.day #
日干支。
[返回对象:timeAlmanacPillarObject](#timeAlmanacPillarObject)
### timeAlmanacDayObject.duty #
建除十二神，如建、除、满、平。
### timeAlmanacDayObject.ecliptic #
黄道或黑道。
### timeAlmanacDayObject.fetus #
胎神占方。
### timeAlmanacDayObject.getHours() #
构造所得对象提供此方法，返回当天13段时辰数组。
### timeAlmanacDayObject.goodGods #
吉神宜趋：字符串数组。
### timeAlmanacDayObject.isLucky #
是否黄道，仅表示十二值神的分类。
### timeAlmanacDayObject.ji #
忌：字符串数组。
### timeAlmanacDayObject.joyDirection #
喜神方位。
### timeAlmanacDayObject.mansion #
二十八宿名称。
### timeAlmanacDayObject.mansionFullName #
二十八宿完整名称，如角木蛟。
### timeAlmanacDayObject.mascotDirection #
福神方位。
### timeAlmanacDayObject.month #
干支月（交节当日整日切换），非农历月。
[返回对象:timeAlmanacPillarObject](#timeAlmanacPillarObject)
### timeAlmanacDayObject.pengZu #
彭祖百忌：两条字符串。
### timeAlmanacDayObject.sha #
日煞方位，如南。
### timeAlmanacDayObject.solarTerm #
当天节气名称；无节气为空字符串。
### timeAlmanacDayObject.twelveStar #
十二值神，如青龙、明堂、天刑。
### timeAlmanacDayObject.wealthDirection #
财神方位。
### timeAlmanacDayObject.yangNobleDirection #
阳贵神方位。
### timeAlmanacDayObject.year #
干支年（立春当日整日切换），非农历年。
[返回对象:timeAlmanacPillarObject](#timeAlmanacPillarObject)
### timeAlmanacDayObject.yi #
宜：字符串数组。
### timeAlmanacDayObject.yinNobleDirection #
阴贵神方位。
## timeAlmanacHourObject 成员列表 #
### timeAlmanacHourObject.datetime #
公历日期时间字符串。
### timeAlmanacHourObject.day #
时宜忌所用日干支（23点为次日）。
[返回对象:timeAlmanacPillarObject](#timeAlmanacPillarObject)
### timeAlmanacHourObject.dayOffset #
23点为1，其余为0；不改变公历日期。
### timeAlmanacHourObject.ecliptic #
黄道或黑道。
### timeAlmanacHourObject.endHour #
当天时段结束小时，不包含；晚子结束为24。
### timeAlmanacHourObject.hour #
时干支。
[返回对象:timeAlmanacPillarObject](#timeAlmanacPillarObject)
### timeAlmanacHourObject.isLucky #
时值神是否为黄道。
### timeAlmanacHourObject.ji #
时忌：字符串数组。
### timeAlmanacHourObject.name #
时辰名称，如子时。
### timeAlmanacHourObject.startHour #
当天时段起始小时，包含。
### timeAlmanacHourObject.twelveStar #
时辰十二值神。
### timeAlmanacHourObject.yi #
时宜：字符串数组。
## timeAlmanacPillarObject 成员列表 #
### timeAlmanacPillarObject.gan #
天干。
### timeAlmanacPillarObject.ganIndex #
天干索引（0~9）。
### timeAlmanacPillarObject.index #
六十甲子索引（0~59，甲子=0）。
### timeAlmanacPillarObject.name #
干支名称。
### timeAlmanacPillarObject.nayin #
纳音。
### timeAlmanacPillarObject.zhi #
地支。
### timeAlmanacPillarObject.zhiIndex #
地支索引（0~11）。