Date 类

可用性

Flash Player 5。

说明

Date 类用于获取相对于通用时间(格林尼治平均时,现在叫做通用时间或 UTC)或相对于运行 Flash Player 的操作系统的日期和时间值。Date 类的方法不是静态的,但仅应用于调用方法时指定的单个 Date 对象。Date.UTC() 方法属于异常,它是一个静态方法。

Date 类以不同的方式处理夏时制,具体方式取决于操作系统和 Flash Player 的版本。在下面的操作系统中,Flash Player 6 及更高版本以这些方式处理夏时制:

在下面的操作系统中,Flash Player 5 处理夏时制方式如下所示:

若要调用 Date 类的方法,必须按照本节后面部分所述使用 Date 类的构造函数创建一个 Date 对象。

Date 类的方法摘要

方法

说明

Date.getDate()

按照本地时间返回某天是当月的第几天。

Date.getDay()

按照本地时间返回某天是周几。

Date.getFullYear()

按照本地时间返回 4 位数字的年份数。

Date.getHours()

按照本地时间返回小时值。 

Date.getMilliseconds()

按照本地时间返回毫秒值。

Date.getMinutes()

按照本地时间返回分钟值。

Date.getMonth()

按照本地时间返回月份数。

Date.getSeconds()

按照本地时间返回秒数。

Date.getTime()

返回自 1970 年 1 月 1 日午夜(通用时间)以来的毫秒数。

Date.getTimezoneOffset()

以分钟为单位,返回计算机的本地时间和通用时间的差值。

Date.getUTCDate()

按照通用时间返回某天(日期)是当月的第几天。

Date.getUTCDay()

按照通用时间返回某天是周几。

Date.getUTCFullYear()

按照通用时间返回 4 位数字的年份数。

Date.getUTCHours()

按照通用时间返回小时值。

Date.getUTCMilliseconds()

按照通用时间返回毫秒值。

Date.getUTCMinutes()

按照通用时间返回分钟值。

Date.getUTCMonth()

按照通用时间返回月份数。

Date.getUTCSeconds()

按照通用时间返回秒数。

Date.getYear()

按照本地时间返回年份数。 

Date.setDate()

按照本地时间设置某天是当月的第几天。返回以毫秒为单位的新时间。

Date.setFullYear()

按照本地时间设置完整的年份数。返回以毫秒为单位的新时间。

Date.setHours()

按照本地时间设置小时值。返回以毫秒为单位的新时间。

Date.setMilliseconds()

按照本地时间设置毫秒值。  返回以毫秒为单位的新时间。

Date.setMinutes()

按照本地时间设置分钟值。返回以毫秒为单位的新时间。

Date.setMonth()

按照本地时间设置月份数。返回以毫秒为单位的新时间。

Date.setSeconds()

按照本地时间设置秒数。返回以毫秒为单位的新时间。

Date.setTime()

以毫秒为单位设置日期。返回以毫秒为单位的新时间。

Date.setUTCDate()

按照通用时间设置日期。返回以毫秒为单位的新时间。

Date.setUTCFullYear()

按照通用时间设置年份数。返回以毫秒为单位的新时间。

Date.setUTCHours()

按照通用时间设置小时值。返回以毫秒为单位的新时间。

Date.setUTCMilliseconds()

按照通用时间设置毫秒值。返回以毫秒为单位的新时间。

Date.setUTCMinutes()

按照通用时间设置分钟值。返回以毫秒为单位的新时间。

Date.setUTCMonth()

按照通用时间设置月份数。返回以毫秒为单位的新时间。

Date.setUTCSeconds()

按照通用时间设置秒数。返回以毫秒为单位的新时间。

Date.setYear()

按照本地时间设置年份数。 

Date.toString()

返回一个表示存储在指定 Date 对象中的日期和时间的字符串值。

Date.UTC()

返回 1970 年 1 月 1 日午夜(通用时间)和指定时间之间的毫秒数。

Date 类的构造函数

可用性

Flash Player 5。

用法

new Date()
new Date(year, month [, date [, hour [, minute [, second [, millisecond ]]]]])

参数

year 一个 0 至 99 之间的值,表示 1900 年至 1999 年;如果年份不在上述范围内,则必须指定表示年份的所有 4 位数字。

month 从 0(一月)到 11(十二月)之间的整数。

date 从 1 到 31 之间的整数。此参数是可选的。

hour 从 0(午夜)到 23(深夜 11 点)之间的整数。

minute 从 0 到 59 之间的整数。此参数是可选的。

second 从 0 到 59 之间的整数。此参数是可选的。

millisecond 从 0 到 999 之间的整数。此参数是可选的。

返回

无。

说明

对象;构造一个新的 Date 对象,该对象保存当前日期和时间或指定的日期。

示例

下面的示例获取当前日期和时间。

now_date = new Date();

以下示例为 Gary 的生日(1974 年 8 月 12 日)创建一个新的 Date 对象。(由于月份参数从零开始,所以此示例使用 7 而不是 8 作为月份。)

garyBirthday_date = new Date (74, 7, 12); 

以下示例创建一个新的 Date 对象,连接 Date.getMonth()Date.getDate()
Date.getFullYear() 的返回值,并在变量 date_str 所指定的文本字段中显示这些值。

today_date = new Date();
date_str = ((today_date.getMonth() + 1) + "/" + today_date.getDate() + "/" + today_date.getFullYear());