{
"from": {
"datetime": "2026-01-31T13:00:00+03:00",
"timezone": "Africa/Nairobi",
"utc_offset": "+03:00",
"abbreviation": "GMT+3",
"utc": "2026-01-31T10:00:00Z",
"unix": 1769853600
},
"to": {
"datetime": "2026-03-15T11:30:00+03:00",
"timezone": "Africa/Nairobi",
"utc_offset": "+03:00",
"abbreviation": "GMT+3",
"utc": "2026-03-15T08:30:00Z",
"unix": 1773563400
},
"direction": "forward",
"total": {
"milliseconds": 3709800000,
"seconds": 3709800,
"minutes": 61830,
"hours": 1030.5,
"days": 42.9375,
"weeks": 6.1339
},
"calendar": {
"years": 0,
"months": 1,
"days": 11,
"hours": 22,
"minutes": 30,
"seconds": 0
},
"note": "Le détail calendaire est calculé sur les dates UTC des deux instants."
}
curl --location --request GET 'https://zylalabs.com/api/15137/clearcheck+date+and+timezone+utilities+api/40391/difference+between+two+datetimes' --header 'Authorization: Bearer YOUR_API_KEY'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 ClearCheck 日期和时区实用工具 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
它会返回两个输入的标准化详细信息,包括原始日期时间、IANA 时区、UTC 偏移量、缩写、UTC 值和 Unix 时间戳。它还会提供方向以及总毫秒数、秒数、分钟数、小时数、天数和周数,随后是日历细分
`total` 字段表示两个时刻之间精确经过的时长。`calendar` 字段提供年、月、日、小时、分钟和秒。根据响应说明,日历详情是使用两个时刻的 UTC 日期计算得出的
工作日计算支持配置周末和节假日。请提供开始日期或日期范围,以及所需的工作日规则和节假日日期。这样,日程安排就能反映当地的工作日历,而不是默认只有周六和周日为非工作日。
它会根据提供的周末和节假日配置,在增加指定数量的工作日后返回到达的日期。可用于截止日期、交付时间估算、发薪日期或其他需要跳过非工作日的日程安排
它根据配置的周末和节假日规则计算两个日期之间的工作日天数。该结果可用于衡量业务处理时间、休假时长、服务窗口,以及其他仅计算日历天数不足以满足需求的时间间隔
转换使用 IANA 时区标识符,例如 `Africa/Nairobi`,并考虑时区偏移的变化,包括夏令时转换。响应可包含转换后的日期时间、UTC 偏移量、缩写、UTC 表示形式和 Unix 时间戳,以便在不同地区之间进行可靠比较
当前时间端点提供所请求的 IANA 时区的当前日期时间上下文,包括与偏移量相关的信息。时区列表端点返回受支持的 IANA 时区标识符,可用于在发送转换请求前验证或填充时区选择输入项
错误使用一致的 JSON 结构:`{"error":{"code","message"}}`。客户端应检查机器可读的 `code` 和人类可读的 `message`,并在重试或显示结果之前验证日期、时区标识符和请求参数