日期/时间输入字符串使用以下过程解码。
将输入字符串分解成标记,并将每个标记归类为字符串、时间、时区或数字。
如果数字标记包含冒号(:
),则这是一个时间字符串。包括所有后续数字和冒号。
如果数字标记包含连字符(-
)、斜杠(/
)或两个或多个点(.
),则这是一个日期字符串,可能包含文本月份。如果已经看到日期标记,则将其解释为时区名称(例如,America/New_York
)。
如果标记仅为数字,则它要么是一个单独的字段,要么是一个 ISO 8601 连接日期(例如,19990113
表示 1999 年 1 月 13 日)或时间(例如,141516
表示 14:15:16)。
如果标记以加号(+
)或减号(-
)开头,则它要么是数字时区,要么是特殊字段。
如果标记是字母字符串,则与可能的字符串匹配
查看标记是否与任何已知时区缩写匹配。这些缩写由第 B.4 节中描述的配置文件提供。
如果未找到,则搜索内部表以将标记匹配为特殊字符串(例如,today
)、日期(例如,Thursday
)、月份(例如,January
)或噪声词(例如,at
、on
)。
如果仍然未找到,则抛出错误。
当标记是数字或数字字段时
如果有八位或六位数字,并且之前没有读取其他日期字段,则解释为“连接日期”(例如,19990118
或 990118
)。解释为 YYYYMMDD
或 YYMMDD
。
如果标记是三位数字并且已经读取了年份,则解释为一年中的第几天。
如果四位或六位数字并且已经读取了年份,则解释为时间(HHMM
或 HHMMSS
)。
如果三位或更多位数字并且尚未找到日期字段,则解释为年份(这强制剩余日期字段的 yy-mm-dd 顺序)。
否则,假设日期字段顺序遵循 DateStyle
设置:mm-dd-yy、dd-mm-yy 或 yy-mm-dd。如果发现月份或日期字段超出范围,则抛出错误。
如果指定了 BC,则取年份的反值并在内部存储中加一。(公历中没有零年,因此数值上 1 BC 变成零年。)
如果未指定 BC,并且年份字段长度为两位,则将年份调整为四位。如果字段小于 70,则加 2000,否则加 1900。
公元 1-99 年可以使用带前导零的 4 位数字输入(例如,0099
是公元 99 年)。
如果您在文档中发现任何不正确的内容,与您对特定功能的体验不符,或者需要进一步澄清,请使用此表单报告文档问题。