节日/节气 API 服务

根据日期自动返回农历节日、公历节日或二十四节气信息

快速开始

Node.js 版本（推荐）

Node.js 版本提供更快的响应速度和更精确的农历计算：

<img src="https://festival2.wifilu.com/" alt="今日节日">

默认返回 302 重定向到对应的节日/节气图片。

Node.js 版本示例

PHP 版本

PHP 版本，功能基本相同：查看 PHP 版本文档

<img src="https://festival.wifilu.com/festival.php" alt="今日节日">

PHP 版本示例

API 参数

参数	类型	必填	默认值	说明
`date`	string	否	当天	指定日期，格式：YYYY-MM-DD
`year`	number	否	今年	年份（与 date 互斥）
`month`	number	否	今月	月份（与 date 互斥）
`day`	number	否	今日	日期（与 date 互斥）
`num`	string	否	随机	图片编号：`1`、`2` 或 `month`（仅 `type=image` 时有效）
`type`	string	否	`image`	返回类型：`image`（图片模式）或 `calendar`（日历信息模式）

参数说明：

date 参数优先于 year/month/day 参数
type=calendar 时返回 JSON 格式的完整日历信息，此时 num 参数无效

返回格式

图片模式（默认）

直接访问 API 地址，返回 302 重定向到对应的节日/节气图片。

GET https://festival2.wifilu.com/

HTTP/1.1 302 Found
Location: https://festival2.wifilu.com/images/春节1.webp

日历信息模式

添加 type=calendar 参数，返回 JSON 格式的完整日历信息。

GET https://festival2.wifilu.com/?type=calendar

{
  "date": "2026-02-17",
  "year": 2026,
  "month": 2,
  "day": 17,
  "weekday": "二",
  "lunar_year": "丙午",
  "lunar_month_name": "正月",
  "lunar_day_name": "初一",
  "festival": "春节",
  "solar_term": "",
  "display_name": "春节",
  "is_leap_month": false
}

字段说明：

date：公历日期字符串（YYYY-MM-DD）
year/month/day：公历年月日
weekday：星期几（中文）
lunar_year：农历年（干支纪年）
lunar_month_name：农历月名称（中文，如"正月"、"腊月"、"闰六月"）
lunar_day_name：农历日名称（中文，如"初一"、"廿五"）
festival：节日名称（无节日时为空字符串）
solar_term：节气名称（非节气日时为空字符串）
display_name：显示名称（优先节日，其次节气）
is_leap_month：是否闰月（布尔值）

使用示例

基础请求

# 使用当前日期（服务器时间）
GET https://festival2.wifilu.com/

# 使用 date 参数
GET https://festival2.wifilu.com/?date=2026-02-17

# 使用 year/month/day 参数
GET https://festival2.wifilu.com/?year=2026&month=2&day=17

图片选择

# 选择第 1 张图片
GET https://festival2.wifilu.com/?date=2026-02-17&num=1

# 选择第 2 张图片
GET https://festival2.wifilu.com/?date=2026-02-17&num=2

# 使用月份图片
GET https://festival2.wifilu.com/?date=2026-02-17&num=month

日历信息模式

# 获取完整日历信息（JSON 格式）
GET https://festival2.wifilu.com/?date=2026-02-17&type=calendar

{
  "date": "2026-02-17",
  "year": 2026,
  "month": 2,
  "day": 17,
  "weekday": "二",
  "lunar_year": "丙午",
  "lunar_month_name": "正月",
  "lunar_day_name": "初一",
  "festival": "春节",
  "solar_term": "立春",
  "display_name": "春节",
  "is_leap_month": false
}

图片 URL 构造规则

所有图片均返回 WebP 格式。

基本格式

# 节日图片
https://festival2.wifilu.com/images/[type/]{节日}{编号}.webp

# 月份图片
https://festival2.wifilu.com/images/month/m_{MM}{编号}.webp

示例

# 节日图片
https://festival2.wifilu.com/images/春节1.webp
https://festival2.wifilu.com/images/春节2.webp
https://festival2.wifilu.com/images/元宵节1.webp

# 月份图片
https://festival2.wifilu.com/images/month/m_021.webp  # 2 月第 1 张
https://festival2.wifilu.com/images/month/m_022.webp  # 2 月第 2 张

# 带类型前缀（仅节日图片支持）
https://festival2.wifilu.com/images/traditional/春节1.webp

说明：

节日图片在 /images/ 目录下
月份图片在 /images/month/ 目录下
未指定 num 时随机返回 1 或 2
使用 type=calendar 可获取完整日历信息，然后根据相关字段自行构造图片 URL

响应状态码

状态码	说明
`200 OK`	请求成功（json/text/url 格式）
`302 Found`	重定向到图片地址（redirect 格式）
`400 Bad Request`	参数错误（如日期格式不正确）
`500 Internal Server Error`	服务器内部错误

支持的节日

农历节日

春节、元宵节、二月二、端午节、七夕节、中秋节、重阳节、腊八、除夕、小年（南/北方）

公历节日

元旦、妇女节、植树节、劳动节、青年节、建党节、教师节、九一八、国庆节、母亲节、父亲节

二十四节气

立春、雨水、惊蛰、春分、清明、谷雨、立夏、小满、芒种、夏至、小暑、大暑、立秋、处暑、白露、秋分、寒露、霜降、立冬、小雪、大雪、冬至、小寒、大寒