批量日期生成器 - 澄曜API Hub

基本信息

接口调用前需要确认的核心配置。

接口地址/api/batch_date_generator

请求方式GET,POST

返回格式JSON

调用权限免费

ApiKey不需要

创建时间2026-05-18

脚本路由batch_date_generator

📊 当前您的权限信息

会员等级

免费用户

调用频率限制

100 次/分钟

可访问API类型

仅免费API

💡 注册成为普通会员可免审核即时获得 Key，调用频率提升至 180 次/分钟。升级VIP 可解锁全部API，调用频率提升至 300 次/分钟。

请求参数说明

必填参数必须传入，示例值可直接用于联调。

💡 统计个人调用次数

免费API不强制要求API Key，但如果您希望统计个人调用次数，请在请求时附加参数 key=您的API_KEY。注册账号后即可获得API Key。

参数名	必填	类型	说明	示例值
`key`	否	string	可选参数：携带此参数可统计您的个人调用次数。请注册账号获取API Key。	`YOUR_API_KEY`
`start_date`	否	string	起始日期(YYYY-MM-DD),与end_date配合使用	`2024-01-01`
`end_date`	否	string	结束日期(YYYY-MM-DD),与start_date配合使用	`2024-12-31`
`count`	否	integer	生成数量,可单独使用或与start_date配合	`365`
`step`	否	integer	日期步长(天),默认1,支持负数	`7`
`format`	否	string	输出格式,默认Y-m-d	`Y/m/d`
`direction`	否	string	方向:forward/backward,默认forward	`backward`
`exclude_weekends`	否	boolean	是否排除周末,默认false	`true`
`exclude_dates`	否	string	排除日期列表(逗号分隔)	`2024-01-01,2024-10-01`
`include_only_weekdays`	否	string	仅包含星期(1-7,逗号分隔,1=周一)	`1,3,5`
`timezone`	否	string	时区,默认Asia/Shanghai	`UTC`

示例代码

优先使用示例地址测试请求参数是否正确。

示例请求

https://api.ruseo.cn/api/batch_date_generator?start_date=2024-01-01&end_date=2024-12-31&count=365&step=7&format=Y%2Fm%2Fd&direction=backward&exclude_weekends=true&exclude_dates=2024-01-01%2C2024-10-01&include_only_weekdays=1%2C3%2C5&timezone=UTC

cURL

curl "https://api.ruseo.cn/api/batch_date_generator?start_date=2024-01-01&end_date=2024-12-31&count=365&step=7&format=Y%2Fm%2Fd&direction=backward&exclude_weekends=true&exclude_dates=2024-01-01%2C2024-10-01&include_only_weekdays=1%2C3%2C5&timezone=UTC"

PHP

$url = 'https://api.ruseo.cn/api/batch_date_generator?start_date=2024-01-01&end_date=2024-12-31&count=365&step=7&format=Y%2Fm%2Fd&direction=backward&exclude_weekends=true&exclude_dates=2024-01-01%2C2024-10-01&include_only_weekdays=1%2C3%2C5&timezone=UTC';
$response = file_get_contents($url);
$data = json_decode($response, true);

JavaScript

fetch('https://api.ruseo.cn/api/batch_date_generator?start_date=2024-01-01&end_date=2024-12-31&count=365&step=7&format=Y%2Fm%2Fd&direction=backward&exclude_weekends=true&exclude_dates=2024-01-01%2C2024-10-01&include_only_weekdays=1%2C3%2C5&timezone=UTC')
  .then(res => res.json())
  .then(data => console.log(data));

返回说明

实际返回内容以接口脚本处理结果为准。

返回示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "route": "batch_date_generator",
        "example": true
    }
}

返回参数说明

参数名	类型	说明	示例值
`input.mode`	string	使用的生成模式	`date_range`
`result.total_count`	integer	理论生成的总数量	`31`
`result.actual_count`	integer	实际返回的日期数量	`31`
`result.excluded_count`	integer	被排除的日期数量	`0`
`result.dates`	array	日期字符串数组	`["2024-01-01", "2024-01-02"]`
`result.weekdays_distribution`	object	星期分布统计	`{"monday":5,"tuesday":5}`
`meta.timezone`	string	使用的时区	`Asia/Shanghai`
`meta.date_range.first`	string	第一个日期	`2024-01-01`
`meta.date_range.last`	string	最后一个日期	`2024-01-31`

调试参数

请求方式接口地址 key (可选，用于统计个人调用) start_date end_date count step format direction exclude_weekends exclude_dates include_only_weekdays timezone

响应结果

◔ --

点击左侧“发送请求”查看结果...