cURL
curl "https://api.ruseo.cn/api/date_diff?start_date=2020-01-01&end_date=2024-12-31"
01
基本信息
接口调用前需要确认的核心配置。
接口地址
/api/date_diff请求方式GET,POST
返回格式JSON
调用权限免费
ApiKey不需要
创建时间2026-05-26
脚本路由
date_diff
02
请求参数说明
必填参数必须传入，示例值可直接用于联调。
💡 统计个人调用次数
免费API不强制要求API Key，但如果您希望统计个人调用次数，请在请求时附加参数 key=您的API_KEY。
注册账号后即可获得API Key。
| 参数名 | 必填 | 类型 | 说明 | 示例值 |
|---|---|---|---|---|
key |
否 | string | 可选参数：携带此参数可统计您的个人调用次数。请注册账号获取API Key。 | YOUR_API_KEY |
start_date |
是 | string | 开始日期，支持Y-m-d/Y/m/d/Y.m.d/Y年m月d日格式 | 2020-01-01 |
end_date |
是 | string | 结束日期，支持多种日期格式 | 2024-12-31 |
03
示例代码
优先使用示例地址测试请求参数是否正确。
示例请求
https://api.ruseo.cn/api/date_diff?start_date=2020-01-01&end_date=2024-12-31
PHP
$url = 'https://api.ruseo.cn/api/date_diff?start_date=2020-01-01&end_date=2024-12-31';
$response = file_get_contents($url);
$data = json_decode($response, true);JavaScript
fetch('https://api.ruseo.cn/api/date_diff?start_date=2020-01-01&end_date=2024-12-31')
.then(res => res.json())
.then(data => console.log(data));
04
返回说明
实际返回内容以接口脚本处理结果为准。
返回示例
{
"code": 0,
"msg": "success",
"data": {
"route": "date_diff",
"example": true
}
}返回参数说明
| 参数名 | 类型 | 说明 | 示例值 |
|---|---|---|---|
code |
integer | 状态码，0=成功 | |
message |
string | 返回消息 | |
data.start_date |
string | 标准化的开始日期（Y-m-d） | |
data.end_date |
string | 标准化的结束日期（Y-m-d） | |
data.swapped |
boolean | 是否交换了日期顺序 | |
data.diff.years |
integer | 年差值 | |
data.diff.months |
integer | 月差值 | |
data.diff.days |
integer | 日差值 | |
data.diff.human |
string | 人性化显示（如"1年2月15日"） | |
data.total.days |
integer | 总天数 | |
data.total.weeks |
integer | 总周数 | |
data.total.workdays |
integer | 工作日天数 | |
data.total.weekends |
integer | 周末天数 | |
data.start_dow_name |
string | 开始日期星期几 | |
data.end_dow_name |
string | 结束日期星期几 | |
data.next_milestone.date |
string | 下一个里程碑日期 | |
data.next_milestone.remain |
integer | 距里程碑剩余天数 | |
响应结果
◔ --
点击左侧“发送请求”查看结果...