Chinese Calendar Skill

获取中国日历信息，包括节假日、调休安排、工作日判断。

When to Use

✅ USE this skill when:

• 判断某天是否是工作日（考虑调休）
• 查询节假日安排
• 了解调休补班情况
• 生成工作日历提醒

❌ DON'T use this skill when:

• 只需要普通日期计算 → use built-in date tools
• 需要农历信息 → use lunar calendar tools
• 需要其他国家节假日 → use international calendar APIs

API Source

使用 timor.tech 提供的免费 API：

• 数据每年自动更新
• 包含国务院发布的节假日安排
• 包含调休、补班信息

Commands

查询某天是否是工作日

# 查询今天
curl -s "https://timor.tech/api/holiday/info/$(date +%Y-%m-%d)"

# 查询指定日期
curl -s "https://timor.tech/api/holiday/info/2026-02-28"

# 查询明天
curl -s "https://timor.tech/api/holiday/info/$(date -d 'tomorrow' +%Y-%m-%d 2>/dev/null || date -v+1d +%Y-%m-%d)"

查询指定年份的所有节假日

# 查询2026年所有节假日
curl -s "https://timor.tech/api/holiday/year/2026/"

批量查询多个日期

# 查询本周所有日期\for day in {0..6}; do
  date_str=$(date -d "$day days" +%Y-%m-%d 2>/dev/null || date -v+${day}d +%Y-%m-%d)
  curl -s "https://timor.tech/api/holiday/info/$date_str"
  echo ""
done

Response Format

工作日/节假日信息

{
  "code": 0,
  "type": {
    "type": 0,      // 0: 工作日, 1: 周末, 2: 节日, 3: 调休
    "name": "工作日",
    "week": 6       // 星期几 (1-7)
  },
  "holiday": {
    "holiday": false,     // 是否放假
    "name": null,         // 节日名称
    "wage": 1,            // 工资倍数 (1, 2, 3)
    "target": null,       // 对应哪个节日
    "after": false,       // 是否是节后补班
    "date": "2026-02-28", // 日期
    "rest": 1             // 休息天数
  }
}

Type 类型说明

Holiday 类型说明

Usage Examples

判断明天是否需要上班

response=$(curl -s "https://timor.tech/api/holiday/info/$(date -d 'tomorrow' +%Y-%m-%d)")
if echo "$response" | grep -q '"holiday":false'; then
  echo "明天是工作日，需要上班"
else
  echo "明天放假，不用上班"
fi

获取下周所有工作日

for day in {1..7}; do
  date_str=$(date -d "$day days" +%Y-%m-%d)
  response=$(curl -s "https://timor.tech/api/holiday/info/$date_str")
  if echo "$response" | grep -q '"holiday":false'; then
    echo "$date_str: 工作日"
  fi
done

查询节假日名称

curl -s "https://timor.tech/api/holiday/info/2026-02-17" | grep -o '"name":"[^"]*"'

PowerShell Usage (Windows)

在 Windows PowerShell 中使用：

# 查询今天
$response = Invoke-RestMethod -Uri "https://timor.tech/api/holiday/info/$(Get-Date -Format 'yyyy-MM-dd')"
$response.type.name
$response.holiday.holiday

# 查询明天
$tomorrow = (Get-Date).AddDays(1).ToString("yyyy-MM-dd")
$response = Invoke-RestMethod -Uri "https://timor.tech/api/holiday/info/$tomorrow"
$response

Integration with OpenClaw

在 Agent 中使用此 skill：

1. 读取本 SKILL.md 了解 API 用法
2. 使用 web_fetch 或 exec 调用 API
3. 解析 JSON 响应
4. 根据结果生成提醒或调整计划

Example Workflow

1. 获取明天的日期
2. 调用 timor.tech API 查询
3. 判断是否是工作日
4. 如果是工作日 → 正常发送下班提醒
5. 如果是假期 → 发送假期祝福，跳过下班提醒

Notes

• API 免费使用，无需注册
• 数据每年由 timor.tech 维护更新
• 节假日安排以国务院发布为准
• 支持年份范围：当年及前后几年

Related

• 农历查询：需配合其他农历 API
• 国际节假日：使用 date.nager.at API