# 支持的时间关键词列表

## 概览
本文档列出了时间解析器支持的所有时间关键词，包括基础时间关键词、节日关键词和农历日期解析。

## 农历日期解析

### 支持的农历日期格式
- 农历[月份][日期] - 例如：农历二月十五、农历三月初八
- [年份修饰]农历[月份][日期] - 例如：明年农历二月二十五、去年农历三月初五
- 农历[年份]年[月份][日期] - 例如：农历2025年二月十五
- 农历闰[月份][日期] - 例如：农历闰二月初五（仅当年有该闰月时有效）

### 中文数字支持
- 月份和日期支持中文数字：一、二、三...十、二十、三十
- 也支持阿拉伯数字：1、2、3...10、20、30

## 基础时间关键词

### 相对日期
- 今天 - 当前日期
- 昨天 - 昨天的日期
- 明天 - 明天的日期
- 前天 - 前天的日期
- 后天 - 后天的日期
- 大前天 - 大前天的日期
- 大后天 - 大后天的日期

### 相对年份
- 今年 - 今年的开始日期（1月1日）
- 去年 - 去年的开始日期（1月1日）
- 明年 - 明年的开始日期（1月1日）

## 节日关键词

### 农历节日
- 今年春节/今年过年 - 今年春节的日期
- 去年春节/去年过年 - 去年春节的日期
- 明年春节/明年过年 - 明年春节的日期

### 公历节日
- 今年五一 - 今年五一国际劳动节（5月1日）
- 去年五一 - 去年五一国际劳动节
- 明年五一 - 明年五一国际劳动节
- 今年十一/今年国庆 - 今年国庆节（10月1日）
- 去年十一/去年国庆 - 去年国庆节
- 明年十一/明年国庆 - 明年国庆节
- 今年元旦 - 今年元旦（1月1日）
- 去年元旦 - 去年元旦
- 明年元旦 - 明年元旦

## 使用示例

### 基础时间关键词示例
```
输入："今天天气怎么样？"
匹配关键词："今天"
输出：当前日期

输入："明天有什么安排？"
匹配关键词："明天"
输出：明天的日期
```

### 节日关键词示例
```
输入："今年春节是哪一天？"
匹配关键词："今年春节"
输出：今年春节的具体日期

输入："去年十一放假几天？"
匹配关键词："去年十一"
输出：去年国庆节的日期（10月1日）
```

### 农历日期示例
```
输入："黄龙的生日是农历二月二十五，明年他的生日是公历的哪一天？"
匹配关键词："明年农历二月二十五"
输出：明年农历二月二十五对应的公历日期

输入："农历三月十五是什么日子？"
匹配关键词："农历三月十五"
输出：今年农历三月十五对应的公历日期

输入："农历2024年八月十五"
匹配关键词："农历2024年八月十五"
输出：2024年农历八月十五对应的公历日期（中秋节）
```

## 输出格式说明

### 成功时的输出格式
```json
{
  "success": true,
  "originalQuery": "用户的原始提问",
  "parsedDate": "YYYY-MM-DD格式的日期",
  "timestamp": 1234567890123,
  "lunarInfo": {
    "year": 农历年,
    "month": 农历月,
    "day": 农历日,
    "isLeapMonth": 是否闰月,
    "zodiac": "生肖",
    "term": "节气"
  },
  "festivalInfo": "节日名称（如春节、劳动节、国庆节等）",
  "isWorkday": true/false,
  "isHoliday": true/false,
  "matchedKeyword": "匹配到的关键词"
}
```

### 新增字段说明
- `festivalInfo`: 使用 chinese-workday 模块获取的节日信息
- `isWorkday`: 是否为工作日（使用 chinese-workday 判断）
- `isHoliday`: 是否为节假日（使用 chinese-workday 判断）

### 失败时的输出格式
```json
{
  "success": false,
  "error": "错误信息",
  "originalQuery": "用户的原始提问"
}
```

## 注意事项
1. 时间解析基于当前系统时间，请确保系统时间准确
2. 农历转换使用lunisolar库，支持大部分常见农历日期
3. 如果未匹配到任何关键词，将返回success: false
4. 时间戳为毫秒级Unix时间戳