xtime
xtime 不是普通的“日期格式化小工具”,而是一组围绕日历、农历、节气和排班时间规则构建的时间能力。
适合什么场景
- 需要从当前时间快速拿到完整日历信息。
- 业务涉及农历、生肖、节气或中文日历表达。
- 想基于仓库内置规则处理固定工作制 / 排班制时间语义。
常用入口
xtime.NowCalendar():获取当前日历对象。(*Calendar).LunarDate():读取农历日期。(*Calendar).Animal():读取生肖。(*Calendar).CurrentSolarTerm():读取当前节气。
使用建议
- 这部分规则具有明显领域语义,不要把它当成普通
time.Time封装来理解。 - 涉及节假日、农历或排班制度时,先确认你的业务规则是否真的与包内模型一致。
- 修改前建议先看
xtime/AGENTS.md,避免用通用时间直觉误判实现细节。