问题报告 纠错本页面

B.1. 日期/时间输入解析

日期/时间类型输入都是使用下列过程进行解码的。

  1. 把输入的字符串分解为一个个记号,然后把每个记号分成字符串、 时间、时区、数字几类:

    1. 如果一个数字记号包含一个冒号(:), 那么这是一个时间字符串。包括随后所有的数据位和冒号。

    2. 如果这个数字记号包含一个划线(-)、斜杠(/)、 多个点(.), 那么它就是一个日期字符串,可能有一个文本月份。 如果一个日期记号已经看过,那么将被解析为时区名(比如America/New_York)。

    3. 如果这个记号只是数字,那么它要么是一个单独的字段, 要么是一个ISO8601连接的日期(比如19990113是1999年1月13日) 或者是连接的时间(比如141516是14:15:16)。

    4. 如果记号以一个加号(+)或减号(-)开头, 那么它要么是一个时区,要么就是一个特殊的字段。

  2. 如果记号是一个文本字符串,那么和可能的字符串进行匹配:

    1. 把这个记号当作时区缩写进行二分表查找。

    2. 如果没有找到,再做一次二分表查找,看看这个记号是特殊字符串 (比如today)、日期(比如Thursday)、 月份(比如January), 还是一个无关痛痒的字 (比如at, on)。

    3. 如果还没有找到,抛出一个错误。

  3. 如果记号是一个数字或者数字字段:

    1. 如果有八位或者六位数字,而且前面也没有读到其它日期字段, 那么就解释成一个"concatenated date(连接的日期)" (比如19990118或者990118)。 这里的解析是YYYYMMDD或者YYMMDD

    2. 如果记号是三位数字,并且已经解码了一个年份,那么解释成一年中的日。

    3. 如果已经读取了四位或六位数字, 并且已经读取了一个年份, 那么就解析成时间(HHMM或者HHMMSS).

    4. 如果是三位或更多位并且还没有找到日期字段,则解析成一个年份 (这个解析强制剩余的日期字段的顺序为yy-mm-dd)。

    5. 否则,日期字段的顺序被认为是遵循DateStyle设置: mm-dd-yy,dd-mm-yy,yy-mm-dd 之一。如果发现月份或者日期字段超出范围, 则抛出一个错误。

  4. 如果声明了BC,则对年份取其负数并加一,用于内部保存。 因为在格里高利历法里没有零年,所以数字上的1BC是公元零年。

  5. 如果没有声明BC并且年份字段有两个数据位的长度,那么把年份调整为4位。 如果该字段小于70,那么加2000,否则加1900。

    Tip: 格里高利年份AD 1-99可以用前导零的方式使用4位数字 (也就是说0099 是AD 99)。