JScript 8.0
Date 对象

此对象启用日期和时间的基本存储和检索。Date 构造函数有两种形式。

function Date( [dateVal : { Number | String | System.DateTime } ] )
function Date( year : int, month : int, date : int[, hours : int [, minutes : int [, seconds : int [, ms : int]]]] )
参数
dateVal

可选项。如果是数值,dateVal 以协调通用时间表示指定日期与 1970 年 1 月 1 日午夜之间相差的毫秒数。如果是字符串,则按照 parse 方法中的规则对 dateVal 进行分析。dateVal 也可以是 .NET 日期值。

year

必选。年份全称,如 1976(而不是 76)。

month

必选。月份,用从 0 到 11 的整数表示(1 月至 12 月)。

date

必选。日期,用从 1 到 31 的整数表示。

hours

可选项。如果提供了 minutes 则必须给出该参数。一个指定小时的,从 0 到 23 的整数(午夜到 11pm)。

minutes

可选项。如果提供了 seconds 则必须给出该参数。一个指定分钟的,从 0 到 59 的整数。

seconds

可选项。如果提供了 milliseconds 则必须给出该参数。一个指定秒的,从 0 到 59 的整数。

ms

可选项。一个指定毫秒的,从 0 到 999 的整数。

备注

Date 对象包含表示特定时间实例(可以精确到毫秒)的数字。如果参数值大于其取值范围或者为负,则会相应地修改存储的其他值。例如,如果指定 150 秒,则 JScript 将该数字重新定义为 2 分 30 秒。

如果数字是 NaN,则对象不表示特定的时间实例。如果没有将任何参数传递到 Date 构造函数,该函数将初始化为当前时间 (UTC)。类型为 Date 的变量在使用之前必须进行初始化。

可在 Date 对象中表示的日期范围大约为 1970 年 1 月 1 日左右的 285,616 年。

Date 对象具有两种静态方法:parseUTC,它们在不创建 Date 对象的情况下进行调用。

如果在不使用 new 的情况下调用 Date 构造函数,那么无论向该构造函数传递什么参数,所返回的 Date 对象都包含当前日期。

Note注意

Date 对象可以与 JScript 中的 .NET Framework System.DateTime 数据类型互用。但是,其他公共语言规范 (CLS) 语言不能使用 Date 对象,因为只有 JScript 提供此对象;它不是从 .NET Framework 类型派生的。因此,当对参数进行类型批注并返回符合 CLS 的方法的类型时,请确保使用 System.DateTime 数据类型,而不是 Date 对象。然而,可以使用 Date 对象对标识符(而不是参数或返回类型)进行类型批注。有关更多信息,请参见编写符合 CLS 的代码

示例

下面的示例使用 Date 对象。

var s : String = "Today's date is: ";   // Declare variables.
var d : Date = new Date();              // Create Date object with today's date.
s += (d.getMonth() + 1) + "/";          // Get month
s += d.getDate() + "/";                 // Get day
s += d.getYear();                       // Get year.
print(s);                               // Print date.

如果该程序在 1992 年 1 月 26 日运行,输出本应该是:

Today's date is: 1/26/1992
属性和方法

Date 对象属性和方法

要求

版本 1

请参见

参考

new 运算符
var 语句