日期差异和工作日 API

API ID 15186

日期差异、自定义周末和节假日的工作日计算、带月末截断的时长计算、时区转换、ISO 周信息和 ISO 8601 时长

58 ms 平均响应

API 文档

端点

请求
精确总时长(秒到周)、完整日历月和年、日历细分(年、月、日、小时、分钟、秒)以及工作日。未指定时区偏移量的输入在提供时按 timeZone 读取,否则按 UTC 读取。范围限制:200 年。
Endpoint ID: 40604
POST https://zylalabs.com/api/15186/date+difference+and+business+days+api/40604/difference+between+two+dates
输入参数

两个日期之间的差异 — 端点功能

对象 描述
请求体 必需 Json

剩余免费测试请求:3 / 3。


输入参数

API 示例响应
JSON
{
    "ok": true,
    "data": {
        "start": "2026-11-02T00:00:00Z",
        "end": "2026-12-01T17:30:00Z",
        "timeZone": null,
        "direction": "forward",
        "totals": {
            "seconds": 2568600,
            "minutes": 42810,
            "hours": 713.5,
            "days": 29.729167,
            "weeks": 4.247024,
            "months": 0,
            "years": 0
        },
        "calendarDays": 29,
        "calendar": {
            "years": 0,
            "months": 0,
            "days": 29,
            "hours": 17,
            "minutes": 30,
            "seconds": 0,
            "iso": "P29DT17H30M"
        },
        "businessDays": 20,
        "businessDayDetails": {
            "convention": "Counts business days after the start date up to and including the end date.",
            "weekendDays": [
                "Sunday",
                "Saturday"
            ],
            "weekendDaysSkipped": 8,
            "holidaysSkipped": 1
        },
        "note": "Inputs without a UTC offset are read in timeZone when given, otherwise as UTC. Calendar math (months, days) runs on wall-clock time; hours, minutes, and seconds are exact elapsed time. totals.months and totals.years are whole calendar units; the other totals are exact elapsed time."
    }
}
两个日期之间的差异 — 代码片段

curl --location --request POST 'https://zylalabs.com/api/15186/date+difference+and+business+days+api/40604/difference+between+two+dates' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{"start":"2026-11-02","end":"2026-12-01T17:30:00Z","holidays":["2026-11-26"]}'

    
请求
先加年和月(限制为该月的最后一天,因此 1 月 31 日 + 1 个月 = 2 月 28 日或 29 日),再按挂钟时间加周和天,最后将小时、分钟和秒作为精确时间添加。传入 timeZone 以获得考虑夏令时的结果
Endpoint ID: 40605
POST https://zylalabs.com/api/15186/date+difference+and+business+days+api/40605/add+or+subtract+a+duration
输入参数

添加或减去一段时长 — 端点功能

对象 描述
请求体 必需 Json

剩余免费测试请求:3 / 3。


输入参数

API 示例响应
JSON
{
    "ok": true,
    "data": {
        "input": "2024-01-31T00:00:00Z",
        "timeZone": null,
        "duration": "P1M2DT3H",
        "applied": {
            "years": 0,
            "months": 1,
            "weeks": 0,
            "days": 2,
            "hours": 3,
            "minutes": 0,
            "seconds": 0
        },
        "result": "2024-03-02T03:00:00Z",
        "resultIso": "2024-03-02T03:00:00Z",
        "resultUtc": "2024-03-02T03:00:00.000Z",
        "resultDate": "2024-03-02",
        "weekday": "Saturday",
        "unixTimestamp": 1709348400,
        "clamped": true,
        "adjustedForDstGap": false,
        "note": "Adding months or years clamps to the last valid day of the target month (for example, Jan 31 + 1 month = Feb 28, or Feb 29 in a leap year). Order: years and months, then weeks and days on the wall clock, then hours, minutes, and seconds as exact elapsed time."
    }
}
添加或减去一段时长 — 代码片段

curl --location --request POST 'https://zylalabs.com/api/15186/date+difference+and+business+days+api/40605/add+or+subtract+a+duration' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{"date":"2024-01-31","duration":"P1M2DT3H"}'

    
请求
向前移动(负数天数时向后移动),跳过周末和节假日。不计算开始日期。天数必须在 ±50,000 范围内,结果必须在开始日期前后 200 年以内
Endpoint ID: 40606
POST https://zylalabs.com/api/15186/date+difference+and+business+days+api/40606/add+business+days+to+a+date
输入参数

向日期添加工作日 — 端点功能

对象 描述
请求体 必需 Json

剩余免费测试请求:3 / 3。


输入参数

API 示例响应
JSON
{
    "ok": true,
    "data": {
        "start": "2026-11-25",
        "startIsBusinessDay": true,
        "days": 3,
        "result": "2026-12-01",
        "weekday": "Tuesday",
        "calendarDaysSpanned": 6,
        "weekendDays": [
            "Sunday",
            "Saturday"
        ],
        "weekendDaysSkipped": 2,
        "holidaysSkipped": 1,
        "note": "The start date is not counted. Each step moves to the next (or previous, for negative days) date that is not a weekend day or holiday. With days = 0 the start date is returned unchanged. Uses the calendar date of the input; any time or offset is ignored."
    }
}
向日期添加工作日 — 代码片段

curl --location --request POST 'https://zylalabs.com/api/15186/date+difference+and+business+days+api/40606/add+business+days+to+a+date' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{"date":"2026-11-25","days":3,"holidays":["2026-11-26"]}'

    
请求
在 IANA 时区之间进行转换。返回 UTC 时刻、UTC 偏移量、夏令时标志、缩写和格式化的本地时间字符串。没有偏移量的日期时间需要提供 from。标记存在歧义的本地时间(夏令时结束时回拨)或不存在的本地时间(春季时钟前拨造成的空档)
Endpoint ID: 40607
POST https://zylalabs.com/api/15186/date+difference+and+business+days+api/40607/convert+a+date-time+between+time+zones
输入参数

在时区之间转换日期时间 — 端点功能

对象 描述
请求体 必需 Json

剩余免费测试请求:3 / 3。


输入参数

API 示例响应
JSON
{
    "ok": true,
    "data": {
        "input": "2026-07-01T12:00:00",
        "utc": "2026-07-01T16:00:00.000Z",
        "unixTimestamp": 1782921600,
        "from": {
            "timeZone": "America/New_York",
            "localDateTime": "2026-07-01T12:00:00",
            "iso": "2026-07-01T12:00:00-04:00",
            "offset": "-04:00",
            "offsetMinutes": -240,
            "isDST": true,
            "abbreviation": "EDT",
            "formatted": "Wednesday, July 1, 2026 at 12:00:00 PM EDT"
        },
        "to": {
            "timeZone": "Europe/London",
            "localDateTime": "2026-07-01T17:00:00",
            "iso": "2026-07-01T17:00:00+01:00",
            "offset": "+01:00",
            "offsetMinutes": 60,
            "isDST": true,
            "abbreviation": "GMT+1",
            "formatted": "Wednesday, July 1, 2026 at 5:00:00 PM GMT+1"
        },
        "offsetDifferenceMinutes": 300,
        "ambiguousLocalTime": false,
        "nonexistentLocalTime": false,
        "note": "Uses the Intl time zone database of the runtime. A local time repeated by a DST fall-back resolves to the earlier instant; a local time skipped by a spring-forward gap moves forward by the gap."
    }
}
在时区之间转换日期时间 — 代码片段

curl --location --request POST 'https://zylalabs.com/api/15186/date+difference+and+business+days+api/40607/convert+a+date-time+between+time+zones' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{"datetime":"2026-07-01T12:00:00","from":"America/New_York","to":"Europe/London"}'

    
请求
ISO 周数和周所属年份、年内日序、季度、星期几、闰年、月份和年份的天数,以及午夜 UTC 时的 Unix 时间戳
Endpoint ID: 40608
GET https://zylalabs.com/api/15186/date+difference+and+business+days+api/40608/calendar+facts+for+a+date
输入参数

某日期的日历信息 — 端点功能

对象 描述
date 必需 ISO date YYYY-MM-DD

剩余免费测试请求:3 / 3。


输入参数

date
API 示例响应
JSON
{
    "ok": true,
    "data": {
        "date": "2024-02-29",
        "year": 2024,
        "month": 2,
        "monthName": "February",
        "day": 29,
        "weekday": "Thursday",
        "weekdayNumber": 4,
        "isoWeekday": 4,
        "isoWeek": 9,
        "isoWeekYear": 2024,
        "isoWeekDate": "2024-W09-4",
        "dayOfYear": 60,
        "daysRemainingInYear": 306,
        "quarter": 1,
        "isLeapYear": true,
        "daysInMonth": 29,
        "daysInYear": 366,
        "isWeekend": false,
        "unixTimestamp": 1709164800,
        "note": "unixTimestamp is midnight UTC at the start of this date, in seconds."
    }
}
某日期的日历信息 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/15186/date+difference+and+business+days+api/40608/calendar+facts+for+a+date?date=2024-02-29' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
将类似 P1Y2M3DT4H5M6S、P2W 或 -PT1.5H 的时长拆分为各个组成部分和总秒数。年和月使用平均长度,并标记为近似值
Endpoint ID: 40609
POST https://zylalabs.com/api/15186/date+difference+and+business+days+api/40609/parse+an+iso+8601+duration
输入参数

解析 ISO 8601 时长 — 端点功能

对象 描述
请求体 必需 Json

剩余免费测试请求:3 / 3。


输入参数

API 示例响应
JSON
{
    "ok": true,
    "data": {
        "input": "P1DT2H3M4.5S",
        "normalized": "P1DT2H3M4.5S",
        "negative": false,
        "components": {
            "years": 0,
            "months": 0,
            "weeks": 0,
            "days": 1,
            "hours": 2,
            "minutes": 3,
            "seconds": 4.5
        },
        "totalSeconds": 93784.5,
        "totalSecondsApproximate": false,
        "note": "Exact: weeks are 7 days, days are 24 hours (DST shifts are not applied without a start date)."
    }
}
解析 ISO 8601 时长 — 代码片段

curl --location --request POST 'https://zylalabs.com/api/15186/date+difference+and+business+days+api/40609/parse+an+iso+8601+duration' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{"duration":"P1DT2H3M4.5S"}'

    
请求
与 POST 版本相同,带有查询参数
Endpoint ID: 40610
GET https://zylalabs.com/api/15186/date+difference+and+business+days+api/40610/format+duration+from+query+seconds
输入参数

剩余免费测试请求:3 / 3。


输入参数

此端点不需要任何输入参数。

API 示例响应
JSON
{
    "ok": true,
    "data": {
        "seconds": 5400,
        "largestUnit": "hours",
        "iso": "PT1H30M",
        "components": {
            "years": 0,
            "months": 0,
            "weeks": 0,
            "days": 0,
            "hours": 1,
            "minutes": 30,
            "seconds": 0
        },
        "note": "Months and years are never emitted because their length varies. Seconds are rounded to milliseconds."
    }
}
从查询秒数格式化时长 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/15186/date+difference+and+business+days+api/40610/format+duration+from+query+seconds' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
将秒数转换为 ISO 8601 时长,使用周、天、小时、分钟和秒(绝不使用月或年)。上限:相当于 200 年的秒数
Endpoint ID: 40611
POST https://zylalabs.com/api/15186/date+difference+and+business+days+api/40611/format+seconds+as+an+iso+8601+duration
输入参数

将秒数格式化为 ISO 8601 时长 — 端点功能

对象 描述
请求体 必需 Json

剩余免费测试请求:3 / 3。


输入参数

API 示例响应
JSON
{
    "ok": true,
    "data": {
        "seconds": 93784.25,
        "largestUnit": "days",
        "iso": "P1DT2H3M4.25S",
        "components": {
            "years": 0,
            "months": 0,
            "weeks": 0,
            "days": 1,
            "hours": 2,
            "minutes": 3,
            "seconds": 4.25
        },
        "note": "Months and years are never emitted because their length varies. Seconds are rounded to milliseconds."
    }
}
将秒数格式化为 ISO 8601 时长 — 代码片段

curl --location --request POST 'https://zylalabs.com/api/15186/date+difference+and+business+days+api/40611/format+seconds+as+an+iso+8601+duration' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{"seconds":93784.25}'

    

API 访问密钥和身份验证

注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 日期差异和工作日 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。

标头
标头 描述
授权 必需 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。

起价
$10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

概览

日期差异、自定义周末和节假日的工作日计算、采用月末截断的时长运算、时区转换、ISO 周信息以及 ISO 8601 时长

日期差异和工作日 API FAQs

默认情况下,计数包括开始日期之后、截至并包括结束日期的工作日。因此,周一到周五的差值为 4,而从周一开始加上 4 个工作日会得到周五,所以差值和加法结果一致。将 includeStart 设为 true,也将开始日期计入,如电子表格中的 NETWORKDAYS 函数

是的。将 weekendDays 作为 0–6 的数字(0 = 星期日)或“Fri”和“Sat”等名称传入。将 holidays 作为最多 366 个 YYYY-MM-DD 格式的日期传入。API 不包含内置节假日日历,因此你需要发送适用于你的日期。

结果会限制为目标月份的最后一个有效日期:2025-02-28,闰年则为 2024-02-29。发生这种情况时,响应会将 clamped 设为 true。2 月 29 日加一年得到 2 月 28 日 .

向 diff 或 add 传入一个 IANA 时区。天和月保持墙上时间不变,而小时、分钟和秒则按实际经过的时间计算。纽约的春季跳时日是 1 个日历日,但只有 23 小时。不存在的本地时间会按时间间隔向前移动,重复的本地时间则解析为较早的时刻。这两种情况都会被标记。

ISO 8601 日期(YYYY-MM-DD)和日期时间(YYYY-MM-DDTHH:MM[:SS[.fff]]),可选带有 Z 或正负 HH:MM 偏移量,年份范围为 0001-9999。如果传入 timeZone,则没有偏移量的值会按该时区读取,否则按 UTC 读取。像 2026-02-29 这样的无效日期会返回 400 错误,并附有清晰的说明。

年和月的长度各不相同,因此 parse-duration 使用它们的平均值(每年 365.2425 天,每月 30.436875 天),并将 totalSecondsApproximate 设为 true。要获得精确结果,请使用 add 端点将时长加到一个实际的开始日期上

ISO 8601 周:每周从星期一开始,第 1 周包含当年的第一个星期四。例如,2021-01-03 属于周序年 2020 的第 53 周。响应中包含 isoWeek 和 isoWeekYear 乐彩

范围和偏移最多可达 200 年,节假日列表最多可包含 366 个日期,工作日步长最多可达正负 50,000,请求正文最多可达 32 KiB。超出这些限制的请求将返回 400 错误并指出相应限制

它返回规范化的开始值和结束值、方向、精确到周的秒数总计、完整的日历月和日历年、日历天数、包含 ISO 时长的日历分解以及工作日结果。工作日详情包括周末规则以及跳过的周末和节假日数量

该端点先应用年和月,再根据本地挂钟时间应用周和天,随后将小时、分钟和秒作为经过的时间应用。响应包含已应用的组成部分、多种格式的结果、星期几、Unix 时间戳、钳制状态以及 DST 间隙调整状态

它会返回原始日期、该日期是否为工作日、请求的偏移量、结果日期和星期、跨越的日历日数、周末设置,以及跳过的周末和节假日数量。偏移天数为零时返回未变更的开始日期;开始日期永远不计入。

响应包含 UTC 时刻和 Unix 时间戳,以及源时区和目标时区对象。每个对象都提供本地日期时间、带偏移量的 ISO 值、以分钟为单位的偏移量、夏令时标志、缩写和格式化文本。它还报告偏移量差异以及本地时间是否存在歧义或不存在的标志

对于给定日期,返回星期、ISO 星期和周日期、ISO 周和周所属年份、一年中的第几天、剩余天数、季度、是否为闰年、该月和该年的天数、是否为周末,以及该日期开始时 UTC 午夜的 Unix 时间戳

解析器返回原始时长和规范化时长、其正负号,以及分别表示年、月、周、日、小时、分钟和秒的组成部分。它还会返回总秒数。涉及年或月的总数是近似值;在固定时长规则下,周、日和更小单位的总数是精确值

格式化端点会返回输入的秒数、选定的最大单位、ISO 时长字符串以及各组成部分的分解。它们使用周、天、小时、分钟和秒,从不使用月或年。例如,5400 秒会转换为 PT1H30M,小数秒会四舍五入到毫秒。

使用 ISO 字符串以实现互操作,使用结构化组件进行计算和显示,并在系统要求使用纪元秒时使用 Unix 时间戳。对于时长,存储或传输时使用 ISO 值,面向用户的标签则使用组件。将结果视为普遍精确之前,请检查近似、钳制和 DST 标志

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。
价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]

此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。
定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。
有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]
价格由月度或年度订阅决定,具体取决于所选计划。
API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。
Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。
要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。
要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。
要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。
"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。
是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。
为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。
7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。
当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。
付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。
您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

相关 API