LOLKU API

主题

日期 / 农历 / 节假日 ​

基于 lunar-javascript 实现，支持公历与农历互查、干支（天干地支）、生肖、星座、二十四节气、中国传统节日和公历节日查询。

日期 / 农历 / 节假日查询 ​

  • 方法: GET
  • 路径: /api/web/tools/datetime

请求参数 (Query) ​

参数类型必填默认值说明
datestring否今天查询日期，格式 YYYY-MM-DD 或 YYYY/M/D

不传参数

不传 date 参数时默认返回当天的日期信息。

请求示例 ​

bash
# 查询今天
GET /api/web/tools/datetime

# 查询指定日期
GET /api/web/tools/datetime?date=2026-02-17

响应示例 ​

json
{
  "code": 200,
  "data": {
    "solar": {
      "year": 2026,
      "month": 2,
      "day": 17,
      "week": 2,
      "weekInChinese": "二",
      "isWeekend": false,
      "xingzuo": "水瓶座"
    },
    "lunar": {
      "year": 2026,
      "month": 1,
      "day": 1,
      "monthInChinese": "正月",
      "dayInChinese": "初一",
      "yearInGanZhi": "丙午",
      "monthInGanZhi": "庚寅",
      "dayInGanZhi": "辛酉",
      "shengXiao": "马",
      "dayNaYin": "石榴木",
      "isLeap": false
    },
    "festivals": ["春节"],
    "jieQi": null
  },
  "message": "success"
}

字段说明 ​

solar（公历） ​

字段说明
year / month / day公历年月日
week星期几（0=周日, 1=周一, ..., 6=周六）
weekInChinese星期中文（日/一/二/三/四/五/六）
isWeekend是否周末
xingzuo星座

lunar（农历） ​

字段说明
year / month / day农历年月日（数字）
monthInChinese农历月中文（如"正月"、"冬月"）
dayInChinese农历日中文（如"初一"、"廿七"）
yearInGanZhi干支年（如"丙午"）
monthInGanZhi干支月
dayInGanZhi干支日
shengXiao生肖（鼠/牛/虎/兔/龙/蛇/马/羊/猴/鸡/狗/猪）
dayNaYin纳音（六十甲子纳音）
isLeap是否闰月

festivals（节日） ​

合并返回公历节日、农历传统节日和其他节日。当天无节日时为 null。

常见节日包括：

类型节日示例
公历节日元旦、情人节、妇女节、劳动节、青年节、儿童节、建党节、建军节、国庆节、圣诞节
农历节日春节、元宵节、端午节、七夕节、中元节、中秋节、重阳节、腊八节、除夕
其他节日植树节、清明节、母亲节、父亲节、感恩节等

jieQi（节气） ​

二十四节气之一，当天非节气日时为 null。

GET在线测试