AS2 认证信息
OFTP 证书
SAP 证书在 EDI 集成、数据映射以及系统间接口交互中，日期与时间格式转换几乎是绕不开的问题。不同系统对日期的格式要求差异极大，一旦处理不当，轻则报文校验失败，重则引发业务数据错误。
在 ArcScript 中，todate() 格式化器正是用于解决这一问题的核心工具之一。本文将围绕 todate() 的使用方式、参数含义、格式差异、常见陷阱以及最佳实践进行系统性讲解，帮助你在实际项目中安全、稳定地处理日期数据。
一、todate() 格式化器概述
todate() 用于将字符串形式的日期解析为日期对象，并按指定格式输出，广泛应用于 EDI 报文的日期字段处理中。
使用方式：
|
1 |
todate([outputformat][, inputformat][, strictInputFormat]) |
二、参数详解
1.outputformat（输出格式）
用于指定最终输出的日期格式，可使用预定义格式或自定义格式字符串，如：
yyyyMMdd、yyyy-MM-dd HH:mm:ss、MM/dd/yyyy 等。
2.inputformat（输入格式）
用于明确指定输入日期字符串的格式。默认值是自动检测。格式化器在解析日期属性时将尝试优先输入格式，但是，如果输入属性不匹配指定的输入格式，格式化器将尝试使用已知（标准）日期格式来解析输入属性。只有当输入属性不匹配指定的输入格式或任何已知的日期格式时，才会抛出错误。
强烈建议在生产项目中显式指定，避免依赖自动识别。
3.strictInputFormat（严格校验）
默认值是false，当设置为 true 时，输入值必须严格匹配 inputformat，否则直接抛错。
总的来说：
三、基础示例
|
1 2 |
<arc:set attr="simpleDate" value="01-30-2020" /> <arc:set attr="reformattedDate" value="[simpleDate | todate('yyyyMMdd', 'MM-dd-yyyy')]" /> |
输出结果：reformattedDate = 20200130
解析逻辑说明：
- 输入字符串：01-30-2020
- inputformat：MM-dd-yyyy
- 转换为日期对象
- 按 yyyyMMdd 格式输出
四、常见日期格式示例
以下是供参考的示例日期格式字符串。 使用它们自定义日期格式化器以适合用例。 由于每个版本支持的内容存在差异，因此本部分包含 跨平台版本 和 .NET 版本 版本的结果 。
对于下表中的每个示例，日期为 2024 年 3 月 5 日。时间为北京时间 (UTC+8) 午夜后 12 小时 31 分 5 秒 336 毫秒。
| 日期格式 | 跨平台版本结果 | .NET 版本结果 |
|---|---|---|
| MM-dd-yy | 03-05-24 | 03-05-24 |
| MM/dd/yyyy HH:mm | 03/05/2024 12:31 | 03/05/2024 12:31 |
| yyyy-MM-dd HH:mm:ss | 2024-03-05 12:31:05 | 2024-03-05 12:31:05 |
| yyyy-MM-dd HH:mm:ss.SSS | 2024-03-05 12:31:05.336 | 不支持 |
| yyyy-MM-dd HH:mm:ss.fff | 2024-03-05 12:31:05.336 | 2024-03-05 12:31:05.336 |
| yyyy-MM-dd HH:mm:ss X | 2024-03-05 17:31:05 +08 | 不支持 |
| ddd dd MMM yyyy HH:mm:ss zzz | Tue 05 Mar 2024 12:31:05 +08:00 | Tue 05 Mar 2024 12:31:05 +08:00 |
| ddd dd MMM yyyy HH:mm:ss z | Tue 05 Mar 2024 12:31:05 +0800 | Tue 05 Mar 2024 12:31:05 +5 |
实战建议：
在多运行环境部署时，应尽量使用 两者都支持的通用格式，避免毫秒与时区字段导致的不兼容问题。
五、包含文字字符的日期格式
当日期格式中包含 T 等字符时，推荐使用 arc:set 标签体方式，避免 XML 属性引号冲突。
示例：
|
1 2 3 |
<arc:set attr="out.data"> [xpath(“TestDate”) | todate("yyyy-MM-dd'T'HH:mm:ss",”yyyyMMdd”)] </arc:set> |
这种写法通过标签体而非 value=”"，可以有效规避字符串被提前截断的问题。
六、三个必须牢记的实战注意事项
1.todate 使用时，尽量显式指定 inputformat
不推荐：
|
1 |
[value | todate('yyyyMMdd')] |
推荐：
|
1 |
[value | todate('yyyyMMdd', 'yyyy-MM-dd')] |
原因：
自动识别在不同地区、不同输入源下存在不确定性，容易导致解析失败。
2.使用前务必判空，否则可能“悄悄出错”
如果输入属性为空：
[value | todate('yyyyMMdd')]
结果不会是空，而是当前系统时间！这在 EDI 报文处理中非常危险，会导致传输错误的时间。
推荐做法：
3.获取当前时间的正确方式
如果你的目的不是转换已有字段，而是获取当前时间：
推荐：
|
1 |
[_ | now | todate('yyyyMMdd')] |
不推荐直接依赖空值触发默认行为。
七、典型 EDI 场景示例
场景：856 报文shipment_date字段需要 yyyyMMdd 格式日期
ERP 输入日期：2023-06-08 15:52:16
EDI 需要格式：yyyyMMdd
先判空：
ArcScript：
|
1 |
[xpath("shipment_date") | todate("yyyyMMdd", "yyyy-MM-dd HH:mm:ss")] |
输出：20230608
八、小结
todate() 看似简单，却是 ArcScript 中最容易踩坑、同时也是最关键的格式化器之一。
EDI上线前todate 使用自查checklist：
- 是否显式指定 inputformat
- 转换前是否先判空
- 是否使用 now()获取当前时间
- 是否确认运行环境
- 是否注意避免使用不兼容的日期格式
掌握这些原则，能让你的 EDI 映射在日期处理上更加稳定、可控，也能显著减少上线后的隐性问题。
注：文案部分图片及内容来源于网络，版权归原创作者所有，如有侵犯到您的权益，请您联系我们进行删除，给您带来困扰，我们深感抱歉。
知行之桥®
