杂项

计算两个日期之间的时间差值

0次调用

免费接口

想知道两个日期之间相差多久？这个接口帮你精确计算时间差值。

POST

uapis.cn

/api/v1/misc/date-diff

Body

start_date

string

required

开始日期，支持多种格式自动识别

end_date

string

required

结束日期，支持多种格式自动识别

format

string

日期格式（可选），如DD-MM-YYYY。不指定则自动识别

功能概述

输入开始日期和结束日期，返回它们之间的时间差，包括总天数、总小时数、总分钟数、总秒数、总周数，以及人性化显示格式（如"1年2月3天"）。

日期格式

接口支持自动识别常见日期格式，包括：YYYY-MM-DD、YYYY/MM/DD、DD-MM-YYYY、ISO 8601（带时区）等。也可以通过format参数显式指定格式（如DD-MM-YYYY）。

小贴士

当结束日期早于开始日期时，返回的数值为负数。

请求体

start_date

string必填

开始日期，支持多种格式自动识别

end_date

string必填

结束日期，支持多种格式自动识别

format

string可选

日期格式（可选），如DD-MM-YYYY。不指定则自动识别

名称	类型	属性	说明
`start_date`	string	必填	开始日期，支持多种格式自动识别
`end_date`	string	必填	结束日期，支持多种格式自动识别
`format`	string	可选	日期格式（可选），如DD-MM-YYYY。不指定则自动识别

响应

200 / 请求成功

计算成功，返回多种单位的时间差值

JSON

{
  // 总天数
  "days": 364,
  // 总小时数
  "hours": 8736,
  // 总分钟数
  "minutes": 524160,
  // 总秒数
  "seconds": 31449600,
  // 总周数
  "weeks": 52,
  // 人性化显示格式
  "human_readable": "52周 0天"
}

400 / 错误的请求

日期解析失败或参数错误

JSON

{
  "error_code": "DATE_PARSE_ERROR",
  "error_message": "解析开始日期失败: 无法识别日期格式: invalid-date",
  "error_details": ""
}

快速上手

选择你的语言查看调用示例

认证方式：

cURL 命令

curl -X POST 'https://uapis.cn/api/v1/misc/date-diff' \
  -H 'Content-Type: application/json' \
  -d '{"start_date": "2025-01-01", "end_date": "2025-12-31"}'

常见问题解答