Business Datetime Resolution API
收藏Business Datetime Resolution API 数据集概述
基本信息
- API 名称: Business Datetime Resolution API
- 提供商: Daymo
- 类别: Business Software
- 订阅用户数: 1
- 定价: BASIC ($0.00/月) 和 PRO ($0.00/---) 计划
核心功能
该 API 能够跨 195 个国家、美国全部 50 个州以及伊斯兰工作周，在单个无状态调用中正确解析业务日期时间。开发者通过 POST 一个起始日期时间、司法管辖区域和偏移量（业务小时或业务天数），API 返回精确的解析后日期时间，同时考虑周末、全国公共假日、次国家层级假日、半天、替代假日、夏令时转换和伊斯兰工作周等因素。
解决的问题
- 错误的 SLA 截止日期: 避免跳过错误假日的"5个工作日"计算
- 错误的交付预计到达时间: 电商平台显示的送达时间不准确
- 错误的工资发放日期: 在德国或海湾国家星期五等公共假日发放工资
- 过时的假日数据: 手动维护的
holidays.json文件落后于立法变更 - 夏令时算术错误: 跨越时钟变更边界添加"8个业务小时"时少算或多算时间
- 伊斯兰工作周空白: 沙特阿拉伯、阿联酋、卡塔尔、巴林和科威特的工作周差异
主要特色对比
| 特性 | 本 API | 多数竞争对手 |
|---|---|---|
| 150 个国家司法管辖区 | ✓ | 40–60 |
| 美国所有 50 个州 | ✓ | 仅美国全国 |
| 德国联邦州（巴伐利亚≠柏林） | ✓ | ✗ |
| 瑞士各州 | ✓ | ✗ |
| 澳大利亚各州 | ✓ | ✗ |
| 海湾地区周五/周六工作周 | ✓ | ✗ |
| 沙特阿拉伯 2013 年周末变更 | ✓ | ✗ |
| 半天（平安夜、纽交所提前收盘） | ✓ | ✗ |
| 替代假日 | ✓ | ✗ |
| 夏令时安全算术 | ✓ | 部分 |
| 无状态，无需数据库 | ✓ | 各不相同 |
技术细节
端点
- POST
/resolve - 基础 URL:
https://business-datetime-resolution-api.p.rapidapi.com
请求字段
| 字段 | 类型 | 必需 | 默认值 | 描述 |
|---|---|---|---|---|
from |
字符串 | 是 | — | ISO 8601 起始日期时间，可追加 Z 表示 UTC |
timezone |
字符串 | 是 | — | IANA 时区名称 |
jurisdiction |
字符串 | 是 | — | ISO 3166-1 alpha-2 国家代码，可带细分 |
add_business_hours |
数字 | 二者选一 | — | 分数制业务小时，范围 0–8760 |
add_business_days |
整数 | 二者选一 | — | 整数业务天数，范围 0–1825 |
calendar |
字符串 | 否 | standard |
行业日历变体 |
work_day_start |
字符串 | 否 | 09:00 |
工作日开始时间（HH:MM） |
work_day_end |
字符串 | 否 | 17:00 |
工作日结束时间（HH:MM） |
注意: add_business_hours 和 add_business_days 只能提供其中一个，同时提供或不提供将返回 422 错误。
响应字段
| 字段 | 类型 | 描述 |
|---|---|---|
result |
字符串 | 解析后的日期时间（ISO 8601 含 UTC 偏移） |
result_utc |
字符串 | 同一时刻的 UTC 表示 |
skipped |
数组 | 解析过程中跳过的每一天详情 |
business_days_consumed |
整数 | 从起始到结果消耗的总日历天数 |
dst_transition_applied |
布尔值 | 是否跨越并正确处理了夏令时边界 |
jurisdiction_verified |
布尔值 | 司法管辖区域是否使用政府验证的假日数据 |
calendar_used |
字符串 | 应用的行业日历变体 |
engine_version |
字符串 | 假日数据版本（YYYY-MM 格式） |
日历变体
| 日历 | 描述 | 主要补充 |
|---|---|---|
standard |
仅全国和次国家层级公共假日 | — |
banking |
银行特定的关闭和半天 | 平安夜（DE）、除夕（DE）、TARGET2 关闭日、CHAPS 关闭日 |
NYSE |
纽约证券交易所交易日历 | 7月3日提前收盘、感恩节后一天、平安夜 |
LSE |
伦敦证券交易所交易日历 | 平安夜提前收盘、新年前夜提前收盘 |
TSX |
多伦多证券交易所交易日历 | TSX 特定关闭日 |
healthcare |
临床和行政医疗日历 | 区域卫生当局关闭日 |
logistics |
仓储和运输承运人日历 | 承运人特定非配送日、旺季附加费 |
government |
政府办公时间 | 国庆日前后延长的假期 |
错误参考
| HTTP 状态码 | 描述 |
|---|---|
| 400 | 请求体格式错误或无法解析 |
| 401 | API 密钥缺失、无效或已被撤销 |
| 402 | 免费层配额（500次/月）已用完 |
| 422 | 请求体包含逻辑或验证错误（如提供两个偏移量、时区未知、司法管辖区域无效等） |
| 429 | 超过计划速率限制（默认 500 次/秒） |
司法管辖区域示例
欧洲
AT 奥地利 · BE 比利时 · CH 瑞士 · CH/GE 日内瓦 · CZ 捷克 · DE 德国 · DE/BY 巴伐利亚 · DE/BE 柏林 · DE/BW 巴登-符腾堡 · DE/HB 不莱梅 · DE/HH 汉堡 · DE/HE 黑森 · DE/NW 北莱茵-威斯特法伦 · DK 丹麦 · ES 西班牙 · ES/CT 加泰罗尼亚 · FI 芬兰 · FR 法国 · GB 英国 · GB/ENG 英格兰和威尔士 · GB/SCT 苏格兰 · GR 希腊 · HU 匈牙利 · IE 爱尔兰 · IT 意大利 · NL 荷兰 · NO 挪威 · PL 波兰 · PT 葡萄牙 · RO 罗马尼亚 · SE 瑞典
美国全部 50 个州
从 US 联邦到 US/WY 怀俄明州的全部州代码
海湾和中东
AE 阿联酋 · BH 巴林 · EG 埃及 · KW 科威特 · MA 摩洛哥 · OM 阿曼 · QA 卡塔尔 · SA 沙特阿拉伯 · TR 土耳其
注意: 所有海湾司法管辖区自动应用周五/周六工作周。沙特阿拉伯 2013 年之前的周四/周五周末已通过精确的 2013 年 6 月 29 日截止日期正确处理。
亚太地区
AU 澳大利亚（含各州） · CN 中国 · HK 香港 · JP 日本 · KR 韩国 · MY 马来西亚 · NZ 新西兰 · PH 菲律宾 · SG 新加坡 · TW 台湾
美洲
AR 阿根廷 · BR 巴西 · CA 加拿大（含各省） · CL 智利 · CO 哥伦比亚 · MX 墨西哥 · PE 秘鲁
非洲
ET 埃塞俄比亚 · GH 加纳 · KE 肯尼亚 · NG 尼日利亚 · TZ 坦桑尼亚 · UG 乌干达 · ZA 南非
