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 日午夜之间相差的协调世界时的毫秒数。 如果是字符串,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 对象都包含当前日期。

提示

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

有关如何使用 Date 对象和相关方法的更多信息,请参见日期和时间计算

示例

下面的示例使用 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 语句