parse 方法

分析一个包含日期的字符串,并返回该日期与 1970 年 1 月 1 日午夜之间相差的毫秒数。

function parse(dateVal : {String | System.DateTime} ) : Number

参数

  • dateVal
    必选。 要么是包含诸如“Jan 5, 1996 08:47:00”格式的日期的字符串,要么是从 ActiveX® 对象或其他对象检索到的 VT_DATE 值。

备注

parse 方法返回一个整数值,此整数表示 dateVal 中所提供的日期与 1970 年 1 月 1 日午夜之间相差的毫秒数。

parse 方法是 Date 对象的一个静态方法。 因为它是一个静态方法,它将按下面的示例中所显示的方法被调用,而不是作为一个已创建的 Date 对象中的一个方法被调用。

var datestring = "November 1, 1997 10:15 AM";
Date.parse(datestring)

下面这些规则控制着 parse 方法所能成功分析的字符串:

  • 短日期可使用“/”或“-”日期分隔符,但是必须符合“月/日/年”的格式,例如“7/20/96”。

  • 以“July 10 1995”形式表示的长日期中的年、月、日可以按任何顺序排列,而且年份可以用 2 位数或 4 位数的形式表示。 如果使用 2 位数的形式来表示年份,则该年份必须大于或等于 70。

  • 括号中的任何文本都被视为注释。 这些括号可以嵌套。

  • 逗号和空格被视为分隔符。 允许使用多个分隔符。

  • 月和日的名称必须具有两个或两个以上的字符。 如果两个字符所组成的名称不唯一,则该名称将解析为最晚的一个匹配日期。 例如,“Ju”被解析为七月,而不是六月。

  • 如果提供一个日期,该日期中所说明的星期数与根据此日期中其他部分所确定的星期数不相符,则此日期中的星期数将被忽略。 例如,尽管 1996 年 11 月 9 日实际上是星期五,但“Tuesday November 9 1996”还是可以被接受并进行分析。 但是结果的 Date 对象中包含的是“Friday November 9 1996”。

  • JScript 处理所有的标准时区,以及协调通用时间 (UTC) 和格林威治标准时间 (GMT)。

  • 用冒号分隔小时、分钟和秒,但所有这些内容并非都需要指定。” “10:”、“10:11”和“10:11:12”都是有效的。

  • 若使用的时钟是 24 小时计时的,那么将中午 12 点之后的时间指定为“PM”是错误的。 例如,“23:15 PM”就是错误的。

  • 包含无效日期的字符串是错误的。 例如,一个包含两个年份或两个月份的字符串是错误的。

示例

下面的示例阐释了 parse 方法的用法。 给函数提供一个日期,则该函数将返回所提供日期与 1970 年 1 月 1 日之间的差。

function GetTimeTest(testdate){
   var s, t;                    //Declare variables.
   var MinMilli = 1000 * 60;       //Initialize variables.
   var HrMilli = MinMilli * 60;
   var DyMilli = HrMilli * 24;
   t = Date.parse(testdate);       //Parse testdate.
   s = "There are "                //Create return string.
   s += Math.round(Math.abs(t / DyMilli)) + " days "
   s += "between " + testdate + " and 1/1/70";
   return(s);                      //Return results.
}

要求

版本 1

应用于:

Date 对象

请参见

其他资源

方法