杂项

查询农历时间

0次调用
免费接口

需要在指定时区下查看某个时间点的农历信息?这个接口可以直接返回完整结果。

GET
uapis.cn
/api/v1/misc/lunartime
查询参数
2
ts
string

Unix 时间戳,支持 10 位秒级或 13 位毫秒级。不传则默认当前时间。

timezone
string

时区名称。支持 IANA 时区(如 Asia/Shanghai)和别名(Shanghai、Beijing)。默认 Asia/Shanghai。

功能概述

支持传入 Unix 时间戳(秒或毫秒)和 IANA 时区名,返回公历时间、星期、农历年月日、干支、生肖、节气与节日信息。不传 ts 时默认使用当前时间,不传 timezone 时默认 Asia/Shanghai

时区说明

  • 支持标准 IANA 时区,例如 Asia/ShanghaiAsia/Tokyo
  • 也支持别名:ShanghaiBeijing
  • 时区非法时返回 400 并提示 invalid timezone: xxx

查询参数

ts
string可选

Unix 时间戳,支持 10 位秒级或 13 位毫秒级。不传则默认当前时间。

timezone
string可选

时区名称。支持 IANA 时区(如 Asia/Shanghai)和别名(Shanghai、Beijing)。默认 Asia/Shanghai。

响应

200 / 请求成功

查询成功,返回指定时间和时区下的农历信息。

JSON
{
  // 原始 ts 入参。
  "query_timestamp": "1707537600",
  // 原始 timezone 入参。
  "query_timezone": "Asia/Shanghai",
  // 解析后的时区。
  "timezone": "Asia/Shanghai",
  // 本地化时间,格式 YYYY-MM-DD HH:mm:ss。
  "datetime": "2024-02-10 12:00:00",
  // RFC3339 时间格式。
  "datetime_rfc3339": "2024-02-10T12:00:00+08:00",
  // 秒级 Unix 时间戳。
  "timestamp_unix": 1707537600,
  // 星期英文。
  "weekday": "Saturday",
  // 星期中文。
  "weekday_cn": "星期六",
  // 农历年份(数字)。
  "lunar_year": 2024,
  // 农历月份(数字)。
  "lunar_month": 1,
  // 农历日期(数字)。
  "lunar_day": 1,
  // 是否闰月。
  "is_leap_month": false,
  // 农历年份中文表示。
  "lunar_year_cn": "二〇二四",
  // 农历月份中文表示。
  "lunar_month_cn": "正月",
  // 农历日期中文表示。
  "lunar_day_cn": "初一",
  // 干支年。
  "ganzhi_year": "甲辰",
  // 干支月。
  "ganzhi_month": "丙寅",
  // 干支日。
  "ganzhi_day": "甲辰",
  // 生肖。
  "zodiac": "龙",
  // 节气名称。有值时返回,无值时可能为空字符串或不返回。
  "solar_term": "",
  // 农历节日数组。
  "lunar_festivals": [
    "春节"
  ],
  // 公历节日数组。
  "solar_festivals": [
    "元旦"
  ]
}

400 / 错误的请求

请求参数错误。timezone 非法时返回 invalid timezone: xxxts 非法时返回 invalid timestamp: xxx

JSON
{
  "code": 400,
  "message": "invalid timezone: xxx"
}