CONVERTTIME

将架构日期和时间戳记字符串转换为 ABSTIME 格式。

语法

条件: INVREQ

此命令是线程安全的。

NOHANDLE、RESP 和 RESP2是常用选项，可添加到所有 EXEC CICS 命令中以处理错误条件。命令语法图和选项说明中没有明确包含这些选项。有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项.

CONVERTTIME 分析因特网上常用的四种不同的日期和时间戳记格式，并在本地时间将它们转换为 ABSTIME (绝对日期和时间) 格式。

ABSTIME 格式提供自 1900 年 1 月 1 日 00:00 起的时间 (压缩十进制)。时间以毫秒为单位，并且始终截断，从不向上舍入。 FORMATTIME 命令可用于将此数据更改为其他格式。

CONVERTTIME 命令可识别以下架构的日期和时间戳记字符串格式:

RFC 1123 格式: HTTP日期和时间戳的首选标准格式，如 RFC 1123 中所述。此格式的日期和时间戳记的示例为 Tue ， 01 Apr 2003 10:01:02 +0000。
RFC 3339 格式: XML dateTime 数据类型，由 RFC 3339 指定，该数据类型来自 ISO 8601 标准。此格式的日期和时间戳记的示例为 2003-04-01T10:01:02.498Z。此格式的日期和时间戳记采用 UTC (全球标准时间)。时区偏移 (-12:00 到 + 12:00) 在日期和时间戳记结束时指示，或者在字母 Z 表示零偏移 (+ 00:00)。示例中显示的秒的小数部分是可选的。
RFC 850 格式: RFC 850 中规定的一种较早的互联网日期和时间戳格式。此格式的日期和时间戳记的示例为星期二， 01-Apr-03 10:01:02 GMT。
重要信息: 由于年份只有两位数字采用此格式，因此 CICS® 使用以下假设: 年份在 1970 到 2069 之间。在以上示例中， CICS 假定文档的日期为 1 2003 年 4 月。给定日期和时间戳记星期四， 13-Feb-98 15:30:00 GMT， CICS 假定文档的日期为 1998 年 2 月 13 日。如果您认为可能会收到此格式的日期和时间戳记，请在对应用程序进行编码时注意此行为。
ASCtime 格式: 由 C® ASCtime 函数生成的日期和时间戳格式。此格式的日期和时间戳记的示例为 Tue Apr 1 10:01:02 2003。

DATESTRING(数据区): 此选项指定 64 个字符的数据区，以包含架构的日期和时间戳记字符串。您可以提供该命令可识别的任何格式的字符串。如果字符串长度小于 64 个字符，请用空格或空字符填充该字符串。您不必在 DATESTRING 选项中指定数据的格式，因为 CICS 会自动读取数据以确定它是否为受支持的格式。将返回的 ABSTIME 的日期和时间转换为本地时间。
ABSTIME(数据区): 此选项指定要接收 ABSTIME 格式的转换日期和时间戳记的数据区。如果日期和时间戳记未采用可识别的格式，那么 ABSTIME 将返回为零。

16 INVREQ

RESP2 值有：

1: 日期和时间戳记字符串的格式无法识别为此命令支持的任何格式。此错误可能是由受支持格式但包含格式错误的日期和时间戳记字符串引起的。例如，大于或小于格式的正确位数的年份值，或者应该是数字但不是数字的项。
2: 时间无效。
3: 月份无效。
4: 无效年份 (包括 1900 年之前的年份)。
5: 无效的日期名称。
6: 指定的月和年的日号无效。
7: 未说明 GMT (对于 RFC 850 格式是必需的)。
8: 秒的分数无效。
9: 时区偏移值无效。