Date 对象
更新:2007 年 11 月
此对象启用日期和时间的基本存储和检索。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 对象具有两种静态方法:parse 和 UTC,它们在不创建 Date 对象的情况下进行调用。
如果在不使用 new 的情况下调用 Date 构造函数,那么无论向该构造函数传递什么参数,所返回的 Date 对象都包含当前日期。
说明: |
---|
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