| 包 | 顶级 |
| 类 | public final dynamic class Date |
| 继承 | Date  Object |
| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Date.UTC() 和 Date.parse() 方法为例外情况，它们属静态方法。
Date 类处理夏令时的方式根据操作系统和运行时版本的不同而有所差异。在以下操作系统中，Flash Player 6 及更高版本以这些方式处理夏时制：
- Windows - Date 对象自动调整其夏时制输出。Date 对象检测在当前区域设置内是否应用了夏时制，如果是，它将检测标准时到夏时制转换的日期和时间。然而，当前有效的转换日期会应用到以前和将来的日期，所以如果该区域设置具有不同的转换日期，则对于以前的日期，夏时制偏差的计算结果可能会不正确。
- Mac OS X - Date 对象自动调整其夏时制输出。Mac OS X 中的时区信息数据库用于确定现在或以前的任何日期或时间是否应该应用夏时制偏差。
- Mac OS 9 - 该操作系统只提供了足够的信息以确定当前日期和时间是否应该应用夏时制偏差。相应地，date 对象假定当前的夏时制偏差应用于以前或将来的所有日期和时间。
在以下操作系统中，Flash Player 5 处理夏时制方式如下所示：
- Windows - 始终应用美国的夏时制规则，但对于那些应用夏时制，但却具有与美国不同的转换时间的欧洲和其他地区，这将导致转换错误。Flash 会正确地检测当前区域设置中是否使用了夏时制。
为了使用 Date 类，需使用 new 运算符构造一个 Date 实例。
ActionScript 3.0 增加了几个新的存取器属性，可用它们来替代用来访问或修改 Date 实例的许多 Date 类方法。ActionScript 3.0 中还包括 toString() 方法的几个新变种，其目的是遵从 ECMA-262 第三版，其中包括：Date.toLocaleString()、Date.toTimeString()、Date.toLocaleTimeString()、Date.toDateString() 和 Date.toLocaleDateString()。
要计算相对时间或经过的时间，请参阅 flash.utils 包中的 getTimer() 方法。
相关 API 元素
公共属性
隐藏继承的公共属性
显示继承的公共属性| 属性 | 由以下参数定义 | ||
|---|---|---|---|
 | constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | |
| date : Number
按照本地时间返回 Date 对象所指定的表示月中某天的值（1 到 31 之间的一个整数）。 | Date | ||
| dateUTC : Number
按照通用时间 (UTC) 返回 Date 对象中的日期值（1 到 31 之间的一个整数）。 | Date | ||
| day : Number [只读]
按照本地时间返回该 Date 所指定的星期值（0 代表星期日，1 代表星期一，依此类推）。 | Date | ||
| dayUTC : Number [只读]
按照通用时间 (UTC) 返回该 Date 中的星期值（0 代表星期日，1 代表星期一，依此类推）。 | Date | ||
| fullYear : Number
按照本地时间返回 Date 对象中的完整年份值（一个 4 位数，例如 2000）。 | Date | ||
| fullYearUTC : Number
按照通用时间 (UTC) 返回 Date 对象中的四位数年份值。 | Date | ||
| hours : Number
按照本地时间返回 Date 对象中一天的小时值（0 到 23 之间的一个整数）。 | Date | ||
| hoursUTC : Number
按照通用时间 (UTC) 返回 Date 对象中一天的小时值（0 到 23 之间的一个整数）。 | Date | ||
| milliseconds : Number
按照本地时间返回 Date 对象中的毫秒值（0 到 999 之间的一个整数）部分。 | Date | ||
| millisecondsUTC : Number
按照通用时间 (UTC) 返回 Date 对象中的毫秒值（0 到 999 之间的一个整数）部分。 | Date | ||
| minutes : Number
按照本地时间返回 Date 对象的分钟值（0 到 59 之间的一个整数）部分。 | Date | ||
| minutesUTC : Number
按照通用时间 (UTC) 返回的 Date 对象的分钟值（0 到 59 之间的一个整数）部分。 | Date | ||
| month : Number
按照本地时间返回 Date 对象的月份值（0 代表一月，1 代表二月，依此类推）。 | Date | ||
| monthUTC : Number
按照通用时间 (UTC) 返回的 Date 对象的月份值（0 [1 月] 到 11 [12 月]）部分。 | Date | ||
| seconds : Number
按照本地时间返回 Date 对象的秒值（0 到 59 之间的一个整数）。 | Date | ||
| secondsUTC : Number
按照通用时间 (UTC) 返回的 Date 对象的秒值（0 到 59 之间的一个整数）部分。 | Date | ||
| time : Number
Date 对象中自 1970 年 1 月 1 日午夜（通用时间）以来的毫秒数。 | Date | ||
| timezoneOffset : Number [只读]
计算机的本地时间和通用时间 (UTC) 之间的差值（以分钟为单位）。 | Date | ||
公共方法
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
Date(yearOrTimevalue:Object, month:Number, date:Number = 1, hour:Number = 0, minute:Number = 0, second:Number = 0, millisecond:Number = 0)
构造一个新的 Date 对象，该对象将保存指定的日期和时间。 | Date | ||
按照本地时间返回 Date 对象指定的月中某天的值（1 到 31 之间的一个整数）。 | Date | ||
按照本地时间返回该 Date 所指定的星期值（0 代表星期日，1 代表星期一，依此类推）。 | Date | ||
按照本地时间返回 Date 对象中的完整年份值（一个 4 位数，如 2000）。 | Date | ||
按照本地时间返回 Date 对象中一天的小时值（0 到 23 之间的一个整数）部分。 | Date | ||
按照本地时间返回 Date 对象中的毫秒值（0 到 999 之间的一个整数）部分。 | Date | ||
按照本地时间返回 Date 对象中的分钟值（0 到 59 之间的一个整数）部分。 | Date | ||
按照本地时间返回该 Date 中的月份值（0 代表一月，1 代表二月，依此类推）部分。 | Date | ||
按照本地时间返回 Date 对象中的秒值（0 到 59 之间的一个整数）部分。 | Date | ||
按照通用时间返回 Date 对象中自 1970 年 1 月 1 日午夜以来的毫秒数。 | Date | ||
以分钟为单位，返回计算机的本地时间和通用时间 (UTC) 之间的差值。 | Date | ||
按照通用时间 (UTC) 返回 Date 对象中表示月中某天的值（1 到 31 之间的一个整数）。 | Date | ||
按照通用时间 (UTC) 返回该 Date 中表示星期的值（0 代表星期日，1 代表星期一，依此类推）。 | Date | ||
按照通用时间 (UTC) 返回 Date 对象中的四位数年份值。 | Date | ||
按照通用时间 (UTC) 返回 Date 对象中一天的小时值（0 到 23 之间的一个整数）。 | Date | ||
按照通用时间 (UTC) 返回 Date 对象中的毫秒值（0 到 999 之间的一个整数）部分。 | Date | ||
按照通用时间 (UTC) 返回 Date 对象中的分钟值（0 到 59 之间的一个整数）部分。 | Date | ||
按照通用时间 (UTC) 返回 Date 对象中的月份值（0 [一月] 到 11 [十二月]）部分。 | Date | ||
按照通用时间 (UTC) 返回 Date 对象中的秒值（0 到 59 之间的一个整数）部分。 | Date | ||
|
表示对象是否已经定义了指定的属性。 | Object | |
|
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
[静态]
按照 UTC 将表示日期的字符串转换为一个数字，它等于自 1970 年 1 月 1 日起已经过的毫秒数。 | Date | ||
|
表示指定的属性是否存在、是否可枚举。 | Object | |
按照本地时间设置月中的某天，并以毫秒为单位返回新时间。 | Date | ||
按照本地时间设置年份值，并以毫秒为单位返回新时间。 | Date | ||
按照本地时间设置小时值，并以毫秒为单位返回新时间。 | Date | ||
按照本地时间设置毫秒值，并以毫秒为单位返回新时间。 | Date | ||
按照本地时间设置分钟值，并以毫秒为单位返回新时间。 | Date | ||
按照本地时间设置月份值以及（可选）日期值，并以毫秒为单位返回新时间。 | Date | ||
|
设置循环操作动态属性的可用性。 | Object | |
按照本地时间设置秒值，并以毫秒为单位返回新时间。 | Date | ||
以毫秒为单位设置自 1970 年 1 月 1 日午夜以来的日期，并以毫秒为单位返回新时间。 | Date | ||
按照通用时间 (UTC) 设置日期值，并以毫秒为单位返回新时间。 | Date | ||
按照通用时间 (UTC) 设置年份值，并以毫秒为单位返回新时间。 | Date | ||
按照通用时间 (UTC) 设置小时值，并以毫秒为单位返回新时间。 | Date | ||
按照通用时间 (UTC) 设置毫秒值，并以毫秒为单位返回新时间。 | Date | ||
按照通用时间 (UTC) 设置分钟值，并以毫秒为单位返回新时间。 | Date | ||
按照通用时间 (UTC) 设置月份值及（可选）日期值，并以毫秒为单位返回新时间。 | Date | ||
按照通用时间 (UTC) 设置秒值以及（可选）毫秒值，并以毫秒为单位返回新时间。 | Date | ||
仅返回星期值和日期值的字符串表示形式，而不返回时间或时区。 | Date | ||
提供一种可覆盖的方法，用于在 Date 对象中自定义值的 JSON 编码。 | Date | ||
仅返回星期值和日期值的字符串表示形式，而不返回时间或时区。 | Date | ||
按本地时间返回星期值、日期值以及时间的字符串表示形式。 | Date | ||
仅返回时间的字符串表示形式，而不返回星期值、日期值、年份或时区。 | Date | ||
返回星期值、日期值、时间和时区的字符串表示形式。 | Date | ||
仅返回时间和时区的字符串表示形式，而不返回星期值和日期值。 | Date | ||
按照通用时间 (UTC) 返回星期值、日期值以及时间的字符串表示形式。 | Date | ||
UTC(year:Number, month:Number, date:Number = 1, hour:Number = 0, minute:Number = 0, second:Number = 0, millisecond:Number = 0):Number [静态]
返回 1970 年 1 月 1 日午夜（通用时间）与参数中指定的时间之间相差的毫秒数。 | Date | ||
按照通用时间返回 Date 对象中自 1970 年 1 月 1 日午夜以来的毫秒数。 | Date | ||
属性详细信息
date | 属性 |
dateUTC | 属性 |
day | 属性 |
dayUTC | 属性 |
fullYear | 属性 |
fullYearUTC | 属性 |
hours | 属性 |
hoursUTC | 属性 |
milliseconds | 属性 |
millisecondsUTC | 属性 |
minutes | 属性 |
minutesUTC | 属性 |
month | 属性 |
monthUTC | 属性 |
seconds | 属性 |
secondsUTC | 属性 |
time | 属性 |
timezoneOffset | 属性 |
构造函数详细信息
Date | () | 构造函数 |
public function Date(yearOrTimevalue:Object, month:Number, date:Number = 1, hour:Number = 0, minute:Number = 0, second:Number = 0, millisecond:Number = 0)| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
构造一个新的 Date 对象，该对象将保存指定的日期和时间。
Date() 构造函数使用最多七个参数（year、month、... millisecond）将日期和时间指定为毫秒。新构造的 Date 对象包含的日期取决于传递的参数的数目和数据类型。
- 如果未传递参数，则赋予 Date 对象当前日期和时间。
- 如果传递一个 Number 数据类型的参数，则基于自 GMT 时间 1970 年 1 月 1 日 0:00:000 以来的毫秒数赋予 Date 对象一个时间值，如独立参数所指定的。
- 如果传递一个 String 数据类型的参数，并且该字符串包含一个有效日期，则 Date 对象包含基于该日期的时间值。
- 如果传递两个或更多个参数，则基于传递的参数值赋予 Date 对象一个时间值，该时间值表示日期的年、月、日、小时、分钟、秒和毫秒。
如果传递一个字符串给 Date 类构造函数，则日期可以有多种格式，但必须至少包括月、日和年。例如，Feb 1 2005 是有效的，而 Feb 2005 则是无效的。下表列出了一些有效格式：
- Day Month Date Hours:Minutes:Seconds GMT Year（例如，“Tue Feb 1 00:00:00 GMT-0800 2005”，这与
toString()一致） - Day Month Date Year Hours:Minutes:Seconds AM/PM（例如，“Tue Feb 1 2005 12:00:00 AM”，这与
toLocaleString()一致） - Day Month Date Year（例如，“Tue Feb 1 2005”，这与
toDateString()一致） - Month/Day/Year（例如，“02/01/2005”）
- Month/Year（例如，“02/2005”）
yearOrTimevalue:Object — 如果指定了其他参数，则此数字表示年份（如 1965）；否则，表示时间值。如果该数字表示年份，则 0 至 99 之间的值表示 1900 年至 1999 年；否则，必须指定表示年份的所有 4 位数字。如果该数字表示时间值（未指定任何其他参数），则为 GMT 时间 1970 年 1 月 1 日 0:00:00 之前或之后的毫秒数；负值表示 GMT 时间 1970 年 1 月 1 日 0:00:00 之前 的某个时间，而正值表示该时间之后的某个时间。
| |
month:Number — 0（一月）到 11（十二月）之间的一个整数。
| |
date:Number (default = 1) | |
hour:Number (default = 0) | |
minute:Number (default = 0) | |
second:Number (default = 0) | |
millisecond:Number (default = 0) |
相关 API 元素
方法详细信息
getDate | () | 方法 |
AS3 function getDate():Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照本地时间返回 Date 对象指定的月中某天的值（1 到 31 之间的一个整数）。本地时间由运行 Flash 运行时的操作系统确定。
Number — Date 对象代表的月中某天的值 (1 - 31)。
|
相关 API 元素
示例 ( 如何使用本示例 )
下例创建一个新的 Date 对象
someBirthday，包含参数 year (1974)、month (10 = November)、day (30)、hour (1) 和 minute (20)。然后，调用 getDate() 方法，以检索月中某天的值。
package {
import flash.display.Sprite;
public class DateExample extends Sprite {
public function DateExample() {
var someBirthday:Date = new Date(1974, 10, 30, 1, 20);
trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974
trace(someBirthday.getDate()); // 30
}
}
}
getDay | () | 方法 |
AS3 function getDay():Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照本地时间返回该 Date 所指定的星期值（0 代表星期日，1 代表星期一，依此类推）。本地时间由运行 Flash 运行时的操作系统确定。
Number — Date 对象代表的星期值的数字版本 (0 - 6)。
|
示例 ( 如何使用本示例 )
下例创建一个新的 Array 对象
weekDayLabels，包含元素 [Sunday,Monday,Tuesday,Wednesday,Thursday,Friday,Saturday]，并创建一个新的 Date 对象 someBirthday，包含参数 year (1974)、month (10 = November)、day (30)、hour (1) 和 minute (20)。然后，两次调用 getDay() 方法，先将月中某天的值显示为 6，然后显示星期值（使用 weekDayLabels）。
var weekDayLabels:Array = new Array("Sunday",
"Monday",
"Tuesday",
"Wednesday",
"Thursday",
"Friday",
"Saturday");
var someBirthday:Date = new Date(1974, 10, 30, 1, 20);
trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974
trace(someBirthday.getDay()); // 6
trace(weekDayLabels[someBirthday.getDay()]); // Saturday
getFullYear | () | 方法 |
AS3 function getFullYear():Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照本地时间返回 Date 对象中的完整年份值（一个 4 位数，如 2000）。本地时间由运行 Flash 运行时的操作系统确定。
Number — Date 对象代表的完整年份值。
|
示例 ( 如何使用本示例 )
下例创建一个新的 Date 对象
someBirthday，包含参数 year (1974)、month (10 = November)、day (30)、hour (1) 和 minute (20)。然后，调用 getFullYear() 方法，以检索四位数年份值。
var someBirthday:Date = new Date(1974, 10, 30, 1, 20); trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974 trace(someBirthday.getFullYear()); // 1974
getHours | () | 方法 |
AS3 function getHours():Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照本地时间返回 Date 对象中一天的小时值（0 到 23 之间的一个整数）。本地时间由运行 Flash 运行时的操作系统确定。
Number — Date 对象代表的一天中的小时值 (0 - 23)。
|
示例 ( 如何使用本示例 )
下例创建一个新的 Date 对象
someBirthday，包含参数 year (1974)、month (10 = November)、day (30)、hour (1) 和 minute (20)。然后，调用 getHours() 和 getMinutes() 方法，以按 24 小时格式检索小时和分钟值。最后，创建一个字符串 localTime，并赋予其调用函数 getUSClockTime() 的结果，后者可依次重新调用 getHours() 和 getMinutes()，从而获得时间 03:05 PM。
var someBirthday:Date = new Date(1974, 10, 30, 15, 5);
trace(someBirthday); // Sat Nov 30 15:20:00 GMT-0800 1974
trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 15:5
var localTime:String = getUSClockTime(someBirthday.getHours(), someBirthday.getMinutes());
trace(localTime); // 03:05 PM
function getUSClockTime(hrs:uint, mins:uint):String {
var modifier:String = "PM";
var minLabel:String = doubleDigitFormat(mins);
if(hrs > 12) {
hrs = hrs-12;
} else if(hrs == 0) {
modifier = "AM";
hrs = 12;
} else if(hrs < 12) {
modifier = "AM";
}
return (doubleDigitFormat(hrs) + ":" + minLabel + " " + modifier);
}
function doubleDigitFormat(num:uint):String {
if(num < 10) {
return ("0" + num);
}
return num as String;
}
getMilliseconds | () | 方法 |
AS3 function getMilliseconds():Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照本地时间返回 Date 对象中的毫秒值（0 到 999 之间的一个整数）部分。本地时间由运行 Flash 运行时的操作系统确定。
Number — Date 对象中的毫秒值部分。
|
示例 ( 如何使用本示例 )
以下示例创建一个不带参数的新 Date 对象
now。然后，调用 getMilliseconds() 方法，以检索 Date 对象 now 创建时的毫秒值。
var now:Date = new Date(); trace(now.getMilliseconds());
getMinutes | () | 方法 |
AS3 function getMinutes():Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照本地时间返回 Date 对象中的分钟值（0 到 59 之间的一个整数）部分。本地时间由运行 Flash 运行时的操作系统确定。
Number — Date 对象中的分钟值部分。
|
示例 ( 如何使用本示例 )
以下示例创建一个不带参数的新 Date 对象
now。然后，调用 getMinutes() 方法，以检索 Date 对象 now 创建时的分钟值。
var now:Date = new Date(); trace(now); trace(now.getMinutes());
getMonth | () | 方法 |
AS3 function getMonth():Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照本地时间返回该 Date 中的月份值（0 代表一月，1 代表二月，依此类推）部分。本地时间由运行 Flash 运行时的操作系统确定。
Number — Date 对象中的月份值 (0 - 11) 部分。
|
示例 ( 如何使用本示例 )
下例创建一个新的 Array 对象
monthLabels，包含元素 January 到 December，并创建一个不带参数的新 Date 对象 now。然后，两次调用 getMonth() 方法，先返回 Date 对象 now 创建之月的月份，再返回月份名称。
var monthLabels:Array = new Array("January",
"February",
"March",
"April",
"May",
"June",
"July",
"August",
"September",
"October",
"November",
"December");
var now:Date = new Date();
trace(now.getMonth());
trace(monthLabels[now.getMonth()]);
getSeconds | () | 方法 |
AS3 function getSeconds():Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照本地时间返回 Date 对象中的秒值（0 到 59 之间的一个整数）部分。本地时间由运行 Flash 运行时的操作系统确定。
Number — Date 对象中的秒值（0 到 59）部分。
|
示例 ( 如何使用本示例 )
以下示例创建一个不带参数的新 Date 对象
now。然后，调用 getSeconds() 方法，以检索 Date 对象 now 创建时的秒值。
var now:Date = new Date(); trace(now.getSeconds());
getTime | () | 方法 |
AS3 function getTime():Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照通用时间返回 Date 对象中自 1970 年 1 月 1 日午夜以来的毫秒数。在比较两个或更多个 Date 对象时，可使用此方法表示某一特定时刻。
Number — Date 对象代表的自 1970 年 1 月 1 日以来的毫秒数。
|
示例 ( 如何使用本示例 )
下例创建一个新的 Date 对象
mlk，包含参数 year (1929)、month (0 = January) 和 day (15)。然后，调用 getTime() 方法，检索自 1970 年 1 月 1 日午夜以来的毫秒值，由于年份设置为 1929，因此该值为负数。
var mlk:Date = new Date(1929, 0, 15); trace(mlk); // Tue Jan 15 00:00:00 GMT-0800 1929 trace(mlk.getTime()); // -1292601600000
下面的示例创建一个不带参数的新 Date 对象 注意：在执行日期计算时务必使用 getTime，因为它在闰年仍可继续工作，而不需要类似以下伪代码一样使用一串 if 逻辑：
now，然后使用以下 DateMath（将在下面创建）类方法从原始 Date 对象 now 创建之时起向其中添加时间：
addSeconds()：向now中添加 30 秒。addMinutes()：向now中添加 30 分钟。addHours()：向 Date 对象now中添加 6 小时。addDays()：向 Date 对象now中添加 30 天。addWeeks()：向now中添加 4 周。
var now:Date = new Date();
trace(now);
trace(DateMath.addSeconds(now, 30));
trace(DateMath.addMinutes(now, 30));
trace(DateMath.addHours(now, 6));
trace(DateMath.addDays(now, 30));
trace(DateMath.addWeeks(now, 4));
class DateMath {
public static function addWeeks(date:Date, weeks:Number):Date {
return addDays(date, weeks*7);
}
public static function addDays(date:Date, days:Number):Date {
return addHours(date, days*24);
}
public static function addHours(date:Date, hrs:Number):Date {
return addMinutes(date, hrs*60);
}
public static function addMinutes(date:Date, mins:Number):Date {
return addSeconds(date, mins*60);
}
public static function addSeconds(date:Date, secs:Number):Date {
var mSecs:Number = secs * 1000;
var sum:Number = mSecs + date.getTime();
return new Date(sum);
}
}
function addMonths(num:Number):void {
currentMonth = currentMonth + num;
if(currentMonth > 12) {
currentYear++;
currentMonth = currentMonth - 12;
}
}
getTimezoneOffset | () | 方法 |
AS3 function getTimezoneOffset():Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
以分钟为单位，返回计算机的本地时间和通用时间 (UTC) 之间的差值。
返回Number — 需要添加到计算机本地时间值中以与 UTC 相等的分钟数。如果计算机时间设置晚于 UTC，则返回值将为负数。
|
示例 ( 如何使用本示例 )
以下示例创建一个不带参数的新 Date 对象
now。然后，调用 getTimezoneOffset() 方法，以检索 now 创建时与通用时间之间的差值（以分钟为单位）。然后将结果除以 60，从而将时区偏移转换为小时。
var date:Date = new Date(); trace(date.getTimezoneOffset() / 60);
getUTCDate | () | 方法 |
AS3 function getUTCDate():Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照通用时间 (UTC) 返回 Date 对象中表示月中某天的值（1 到 31 之间的一个整数）。
Number — Date 对象代表的 UTC 时间月中某天的值（1 到 31）。
|
相关 API 元素
示例 ( 如何使用本示例 )
下例创建一个新的 Date 对象
someBirthday，包含参数 year (1974)、month (10 = November)、day (30)、hour (1) 和 minute (20)。然后，调用 getUTCDate() 方法，以根据 UTC 检索月中某天的值。
var someBirthday:Date = new Date(1974, 10, 30, 1, 20); trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974 trace(someBirthday.getUTCDate()); // 30
getUTCDay | () | 方法 |
AS3 function getUTCDay():Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照通用时间 (UTC) 返回该 Date 中表示星期的值（0 代表星期日，1 代表星期一，依此类推）。
Number — Date 对象代表的 UTC 时间的星期值（0 到 6）。
|
相关 API 元素
示例 ( 如何使用本示例 )
下例创建一个新的 Array 对象
weekDayLabels，包含元素 [Sunday,Monday,Tuesday,Wednesday,Thursday,Friday,Saturday]，并创建一个新的 Date 对象 someBirthday，包含参数 year (1974)、month (10 = November)、day (30)、hour (1) 和 minute (20)。然后，两次调用 getUTCDay() 方法，按照 UTC 先将月中某天的值显示为 6，然后显示星期值（使用 weekDayLabels）。
var weekDayLabels:Array = new Array("Sunday",
"Monday",
"Tuesday",
"Wednesday",
"Thursday",
"Friday",
"Saturday");
var someBirthday:Date = new Date(1974, 10, 30, 1, 20);
trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974
trace(someBirthday.getUTCDay()); // 6
trace(weekDayLabels[someBirthday.getUTCDay()]); // Saturday
getUTCFullYear | () | 方法 |
AS3 function getUTCFullYear():Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照通用时间 (UTC) 返回 Date 对象中的四位数年份值。
Number — Date 对象代表的 UTC 时间的四位数年份值。
|
相关 API 元素
示例 ( 如何使用本示例 )
下例创建一个新的 Date 对象
someBirthday，包含参数 year (1974)、month (10 = November)、day (30)、hour (1) 和 minute (20)。然后，调用 getUTCFullYear() 方法，以根据 UTC 检索四位数年份值。
var someBirthday:Date = new Date(1974, 10, 30, 1, 20); trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974 trace(someBirthday.getUTCFullYear()); // 1974
getUTCHours | () | 方法 |
AS3 function getUTCHours():Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照通用时间 (UTC) 返回 Date 对象中一天的小时值（0 到 23 之间的一个整数）。
Number — Date 对象代表的一天中的 UTC 小时值（0 到 23）。
|
相关 API 元素
示例 ( 如何使用本示例 )
下例创建一个新的 Date 对象
someBirthday，包含参数 year (1974)、month (10 = November)、day (30)、hour (1) 和 minute (20)。然后，调用 getHours() 和 getMinutes() 方法，以按 24 小时格式检索小时和分钟值。最后，创建一个字符串 localTime，并赋予其调用函数 getUSClockTime() 的结果，后者可依次重新调用 getHours() 和 getMinutes()，从而获得时间 03:05 PM。最终，采用与 localTime 相同的方式创建了一个字符串变量 utcTime，在这种情况下，获得的结果是一样的。
var someBirthday:Date = new Date(1974, 10, 30, 15, 5);
trace(someBirthday); // Sat Nov 30 15:20:00 GMT-0800 1974
trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 15:5
var localTime:String = getUSClockTime(someBirthday.getHours(), someBirthday.getMinutes());
trace(localTime); // 03:05 PM
var utcTime:String = getUSClockTime(someBirthday.getUTCHours(), someBirthday.getUTCMinutes());
trace(utcTime); // 11:05 PM
function getUSClockTime(hrs:uint, mins:uint):String {
var modifier:String = "PM";
var minLabel:String = doubleDigitFormat(mins);
if(hrs > 12) {
hrs = hrs-12;
} else if(hrs == 0) {
modifier = "AM";
hrs = 12;
} else if(hrs < 12) {
modifier = "AM";
}
return (doubleDigitFormat(hrs) + ":" + minLabel + " " + modifier);
}
function doubleDigitFormat(num:uint):String {
if(num < 10) {
return ("0" + num);
}
return num;
}
getUTCMilliseconds | () | 方法 |
AS3 function getUTCMilliseconds():Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照通用时间 (UTC) 返回 Date 对象中的毫秒值（0 到 999 之间的一个整数）部分。
Number — Date 对象中的 UTC 毫秒值部分。
|
示例 ( 如何使用本示例 )
以下示例创建一个不带参数的新 Date 对象
now。然后，调用 getUTCMilliseconds() 方法，以按照 UTC 检索 Date 对象 now 创建时的毫秒值
var now:Date = new Date(); trace(now.getUTCMilliseconds());
getUTCMinutes | () | 方法 |
AS3 function getUTCMinutes():Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照通用时间 (UTC) 返回 Date 对象中的分钟值（0 到 59 之间的一个整数）部分。
Number — Date 对象中的 UTC 分钟值部分。
|
示例 ( 如何使用本示例 )
以下示例创建一个不带参数的新 Date 对象
now。然后，调用 getUTCMinutes() 方法，以按照 UTC 检索 Date 对象 now 创建时的分钟值
var now:Date = new Date(); trace(now.getUTCMinutes());
getUTCMonth | () | 方法 |
AS3 function getUTCMonth():Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照通用时间 (UTC) 返回 Date 对象中的月份值（0 [一月] 到 11 [十二月]）部分。
Number — Date 对象中的 UTC 月份值部分。
|
相关 API 元素
示例 ( 如何使用本示例 )
下例创建一个新的 Array 对象
monthLabels，包含元素 January 到 December，并创建一个不带参数的新 Date 对象 now。然后，两次调用 getUTCMonth() 方法，按照 UTC 先返回 Date 对象 now 创建之月的月份，再返回月份名称
var monthLabels:Array = new Array("January",
"February",
"March",
"April",
"May",
"June",
"July",
"August",
"September",
"October",
"November",
"December");
var now:Date = new Date();
trace(now.getMonth());
trace(now.getUTCMonth());
trace(monthLabels[now.getUTCMonth()]);
getUTCSeconds | () | 方法 |
AS3 function getUTCSeconds():Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照通用时间 (UTC) 返回 Date 对象中的秒值（0 到 59 之间的一个整数）部分。
Number — Date 对象中的 UTC 秒值部分。
|
示例 ( 如何使用本示例 )
以下示例创建一个不带参数的新 Date 对象
now。然后，调用 getUTCSeconds() 方法，以按照 UTC 检索 Date 对象 now 创建时的秒值
var now:Date = new Date(); trace(now.getUTCSeconds());
parse | () | 方法 |
public static function parse(date:String):Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照 UTC 将表示日期的字符串转换为一个数字，它等于自 1970 年 1 月 1 日起已经过的毫秒数。
参数
date:String — 日期的字符串表示形式，符合 Date.toString() 的输出格式。Date.toString() 输出的日期格式为：
Day Mon DD HH:MM:SS TZD YYYY
例如：
Wed Apr 12 15:30:17 GMT-0700 2006
Time Zone Designation (TZD) 的形式始终为
MM/DD/YYYY HH:MM:SS TZD
HH:MM:SS TZD Day Mon/DD/YYYY
Mon DD YYYY HH:MM:SS TZD
Day Mon DD HH:MM:SS TZD YYYY
Day DD Mon HH:MM:SS TZD YYYY
Mon/DD/YYYY HH:MM:SS TZD
YYYY/MM/DD HH:MM:SS TZD
|
Number — 表示按 UTC 自 1970 年 1 月 1 日起已经过的毫秒数。
|
相关 API 元素
示例 ( 如何使用本示例 )
以下示例将一个日期字符串赋予
dateParsed 以表示 1974 年 11 月 30 日。然后，调用 Date.parse() 方法，以便将该日期转换为自 1970 年 1 月 1 日起的毫秒数。
var dateParsed:String = "Sat Nov 30 1974"; var milliseconds:Number = Date.parse(dateParsed); trace(milliseconds); // 155030400000
setDate | () | 方法 |
AS3 function setDate(day:Number):Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照本地时间设置月中的某天，并以毫秒为单位返回新时间。本地时间由运行 Flash 运行时的操作系统确定。
参数
day:Number — 1 到 31 之间的一个整数。
|
Number — 新时间，以毫秒为单位。
|
示例 ( 如何使用本示例 )
下例创建一个新的 Date 对象
someBirthday，包含参数 year (1974)、month (10 = November)、day (30)、hour (1) 和 minute (20)。然后，调用 getDate() 方法，以检索月中某天的值。接着，调用 setDate()（其中的 day 参数设置为 20），然后再次调用 getDate()，以检索新设置的月中某天的值。
var someBirthday:Date = new Date(1974, 10, 30, 1, 20); trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974 trace(someBirthday.getDate()); // 30 someBirthday.setDate(20); trace(someBirthday.getDate()); // 20
setFullYear | () | 方法 |
AS3 function setFullYear(year:Number, month:Number, day:Number):Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照本地时间设置年份值，并以毫秒为单位返回新时间。如果指定了 month 和 day 参数，则将它们设置为本地时间。本地时间由运行 Flash 运行时的操作系统确定。
调用此方法不会修改 Date 的其他字段，但如果因调用该方法而导致星期值发生变化，则 Date.getUTCDay() 和 Date.getDay() 会报告一个新值。
参数
year:Number — 指定年份的 4 位数。两位数的数字不代表四位数的年份；例如，99 不代表 1999 年，而是表示 99 年。
| |
month:Number — 0（一月）到 11（十二月）之间的一个整数。
| |
day:Number — 1 到 31 之间的一个数字。
|
Number — 新时间，以毫秒为单位。
|
相关 API 元素
示例 ( 如何使用本示例 )
下例创建一个新的 Date 对象
someBirthday，包含参数 year (1974)、month (10 = November)、day (30)、hour (1) 和 minute (20)。然后，调用 getFullYear() 方法，以检索四位数年份值。接着，调用 setFullYear()（其中的 year 参数设置为 2000），然后再次调用 getFullYear()，以检索新设置的年份值。
var someBirthday:Date = new Date(1974, 10, 30, 1, 20); trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974 trace(someBirthday.getFullYear()); // 1974 someBirthday.setFullYear(2000); trace(someBirthday.getFullYear()); // 2000
setHours | () | 方法 |
AS3 function setHours(hour:Number, minute:Number, second:Number, millisecond:Number):Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照本地时间设置小时值，并以毫秒为单位返回新时间。本地时间由运行 Flash 运行时的操作系统确定。
参数
hour:Number — 0（午夜）到 23（晚上 11 点）之间的一个整数。
| |
minute:Number — 0 到 59 之间的一个整数。
| |
second:Number — 0 到 59 之间的一个整数。
| |
millisecond:Number — 0 到 999 之间的一个整数。
|
Number — 新时间，以毫秒为单位。
|
示例 ( 如何使用本示例 )
下例创建一个新的 Date 对象
someBirthday，包含参数 year (1974)、month (10 = November)、day (30)、hour (1) 和 minute (20)。然后，调用方法 getHours() 和 getMinutes()，以检索小时和分钟值。接着，调用 setHours()（其中的 hour 参数设置为 12），然后再次调用 getHours() 和 getMinutes()，以检索新设置的小时和分钟值。
var someBirthday:Date = new Date(1974, 10, 30, 15, 20); trace(someBirthday); // Sat Nov 30 15:20:00 GMT-0800 1974 trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 15:20 someBirthday.setHours(12); trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 12:20
setMilliseconds | () | 方法 |
AS3 function setMilliseconds(millisecond:Number):Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照本地时间设置毫秒值，并以毫秒为单位返回新时间。本地时间由运行 Flash 运行时的操作系统确定。
参数
millisecond:Number — 0 到 999 之间的一个整数。
|
Number — 新时间，以毫秒为单位。
|
示例 ( 如何使用本示例 )
以下示例创建一个不带参数的新 Date 对象
now。然后，调用方法 getMilliseconds()，以检索 now 创建时的毫秒值。接下来，再创建一个新 Date 对象 before，再调用 setMilliseconds()（其中的 millisecond 参数设置为 4），并再次调用 getMilliseconds()，以检索新设置的毫秒值。
var now:Date = new Date(); trace(now); trace(now.getMilliseconds()); var before:Date = new Date(now.setMilliseconds(4)); trace(before); trace(before.getMilliseconds());
setMinutes | () | 方法 |
AS3 function setMinutes(minute:Number, second:Number, millisecond:Number):Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照本地时间设置分钟值，并以毫秒为单位返回新时间。本地时间由运行 Flash 运行时的操作系统确定。
参数
minute:Number — 0 到 59 之间的一个整数。
| |
second:Number — 0 到 59 之间的一个整数。
| |
millisecond:Number — 0 到 999 之间的一个整数。
|
Number — 新时间，以毫秒为单位。
|
示例 ( 如何使用本示例 )
以下示例创建一个不带参数的新 Date 对象
now。然后，调用方法 getMinutes()，以检索 now 创建时的分钟值。接下来，再创建一个新 Date 对象 before，再调用 setMinutes()（其中的 minute 参数设置为 0），并再次调用 getMinutes()，以检索新设置的分钟值。
var now:Date = new Date(); trace(now); trace(now.getMinutes()); var before:Date = new Date(now.setMinutes(0)); trace(before); trace(before.getMinutes());
setMonth | () | 方法 |
AS3 function setMonth(month:Number, day:Number):Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照本地时间设置月份值以及（可选）日期值，并以毫秒为单位返回新时间。本地时间由运行 Flash 运行时的操作系统确定。
参数
month:Number — 0（一月）到 11（十二月）之间的一个整数。
| |
day:Number — 1 到 31 之间的一个整数。
|
Number — 新时间，以毫秒为单位。
|
示例 ( 如何使用本示例 )
下例创建一个新的 Array 对象
monthLabels，包含元素 January 到 December，并创建一个不带参数的新月份对象 now。然后，调用方法 getMonth()，以检索 now 创建时的月份值。接着调用 setMonth()（其中的 month 参数设置为 0），然后再次调用 getMonth()，以检索新设置的月份值。
var monthLabels:Array = new Array("January",
"February",
"March",
"April",
"May",
"June",
"July",
"August",
"September",
"October",
"November",
"December");
var now:Date = new Date();
trace(now.getMonth());
trace(monthLabels[now.getMonth()]);
now.setMonth(0);
trace(now.getMonth()); // 0
trace(monthLabels[now.getMonth()]); // January
setSeconds | () | 方法 |
AS3 function setSeconds(second:Number, millisecond:Number):Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照本地时间设置秒值，并以毫秒为单位返回新时间。本地时间由运行 Flash 运行时的操作系统确定。
参数
second:Number — 0 到 59 之间的一个整数。
| |
millisecond:Number — 0 到 999 之间的一个整数。
|
Number — 新时间，以毫秒为单位。
|
示例 ( 如何使用本示例 )
以下示例创建一个不带参数的新 Date 对象
now。然后，调用方法 getseconds()，以检索 now 创建时的秒值。然后，调用 setSeconds()（其中的 second 参数设置为 0），并再次调用 getSeconds()，以检索新设置的秒值。
var now:Date = new Date(); trace(now.getSeconds()); now.setSeconds(0); trace(now.getSeconds()); // 0
setTime | () | 方法 |
AS3 function setTime(millisecond:Number):Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
以毫秒为单位设置自 1970 年 1 月 1 日午夜以来的日期，并以毫秒为单位返回新时间。
参数
millisecond:Number — 一个整数值，其中 0 表示通用时间 (UTC) 1 月 1 日午夜。
|
Number — 新时间，以毫秒为单位。
|
示例 ( 如何使用本示例 )
以下示例创建一个不带参数的新 Date 对象
now。然后，调用 setTime() 方法（其中的 millisecond 参数设置为 -1292601600000），以将时间设置为 Tue Jan 15 00:00:00 GMT-0800 1929。
var now:Date = new Date(); trace(now); now.setTime(-1292601600000); trace(now); // Tue Jan 15 00:00:00 GMT-0800 1929
setUTCDate | () | 方法 |
AS3 function setUTCDate(day:Number):Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照通用时间 (UTC) 设置日期值，并以毫秒为单位返回新时间。调用此方法不会修改 Date 对象的其他字段，但如果因调用该方法而导致星期值发生变化，则 Date.getUTCDay() 和 Date.getDay() 方法会报告一个新值。
参数
day:Number — 一个数字；1 到 31 之间的一个整数。
|
Number — 新时间，以毫秒为单位。
|
相关 API 元素
示例 ( 如何使用本示例 )
下例创建一个新的 Date 对象
someBirthday，包含参数 year (1974)、month (10 = November)、day (30)、hour (1) 和 minute (20)。调用方法 getUTCDate() 并正确返回月中某天的值。接着，调用 setUTCDate()（其中的 day 参数设置为 1），并且 trace() 语句确认该日期的设置正确。
var someBirthday:Date = new Date(1974, 10, 30, 1, 20); trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974 trace(someBirthday.getUTCDate()); // 30 someBirthday.setUTCDate(1); trace(someBirthday); // Fri Nov 1 01:20:00 GMT-0800 1974
setUTCFullYear | () | 方法 |
AS3 function setUTCFullYear(year:Number, month:Number, day:Number):Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照通用时间 (UTC) 设置年份值，并以毫秒为单位返回新时间。
另外，还可以使用该方法设置月份和月中的某一天。调用此方法不会修改其他字段，但如果因调用该方法而导致星期值发生变化，则 Date.getUTCDay() 和 Date.getDay() 方法会报告一个新值。
参数
year:Number — 一个整数，表示以完整的四位数年份形式指定的年份，如 2000。
| |
month:Number — 0（一月）到 11（十二月）之间的一个整数。
| |
day:Number — 1 到 31 之间的一个整数。
|
Number — 一个整数。
|
相关 API 元素
示例 ( 如何使用本示例 )
下例创建一个新的 Date 对象
someBirthday，包含参数 year (1974)、month (10 = November)、day (30)、hour (1) 和 minute (20)。调用方法 getUTCFullYear() 并正确返回四位数年份值。接着，调用 setUTCFullYear()（其中的 year 参数设置为 1975），并且 trace() 语句确认该年份的设置正确。
var someBirthday:Date = new Date(1974, 10, 30, 1, 20); trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974 trace(someBirthday.getUTCFullYear()); // 1974 someBirthday.setUTCFullYear(1975); trace(someBirthday); // Thu Nov 30 01:20:00 GMT-0800 1975
setUTCHours | () | 方法 |
AS3 function setUTCHours(hour:Number, minute:Number, second:Number, millisecond:Number):Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照通用时间 (UTC) 设置小时值，并以毫秒为单位返回新时间。还可指定分钟值、秒值和毫秒值。
参数
hour:Number — 0（午夜）到 23（晚上 11 点）之间的一个整数。
| |
minute:Number — 0 到 59 之间的一个整数。
| |
second:Number — 0 到 59 之间的一个整数。
| |
millisecond:Number — 0 到 999 之间的一个整数。
|
Number — 新时间，以毫秒为单位。
|
示例 ( 如何使用本示例 )
下例创建一个新的 Date 对象
someBirthday，包含参数 year (1974)、month (10 = November)、day (30)、hour (1) 和 minute (20)。然后，调用方法 getHours()、getMinutes()、getUTCHours() 和 getUTCMinutes()，以检索小时和分钟值。接着，调用 setUTCHours()（其中的 hour 参数设置为 12），然后再次调用方法 getHours()、getMinutes()、getUTCHours() 和 getUTCMinutes()，并正确显示更新的小时值。
var someBirthday:Date = new Date(1974, 10, 30, 15, 20); trace(someBirthday); // Sat Nov 30 15:20:00 GMT-0800 1974 trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 15:20 trace(someBirthday.getUTCHours() + ":" + someBirthday.getUTCMinutes()); // 23:20 someBirthday.setUTCHours(12); trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 4:20 trace(someBirthday.getUTCHours() + ":" + someBirthday.getUTCMinutes()); // 12:20
setUTCMilliseconds | () | 方法 |
AS3 function setUTCMilliseconds(millisecond:Number):Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照通用时间 (UTC) 设置毫秒值，并以毫秒为单位返回新时间。
参数
millisecond:Number — 0 到 999 之间的一个整数。
|
Number — 新时间，以毫秒为单位。
|
示例 ( 如何使用本示例 )
以下示例创建一个不带参数的新 Date 对象
now。然后，调用方法 getUTCMilliseconds()，以检索 now 创建时的 UTC 毫秒值。接下来，再创建一个新 Date 对象 before，再调用 setUTCMilliseconds()（其中的 millisecond 参数设置为 4），并再次调用 getUTCMilliseconds()，以检索新设置的毫秒值。
var now:Date = new Date(); trace(now); trace(now.getUTCMilliseconds()); var before:Date = new Date(now.setUTCMilliseconds(4)); trace(before); trace(before.getUTCMilliseconds());
setUTCMinutes | () | 方法 |
AS3 function setUTCMinutes(minute:Number, second:Number, millisecond:Number):Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照通用时间 (UTC) 设置分钟值，并以毫秒为单位返回新时间。还可以指定秒值和毫秒值。
参数
minute:Number — 0 到 59 之间的一个整数。
| |
second:Number — 0 到 59 之间的一个整数。
| |
millisecond:Number — 0 到 999 之间的一个整数。
|
Number — 新时间，以毫秒为单位。
|
示例 ( 如何使用本示例 )
以下示例创建一个不带参数的新 Date 对象
now。然后，调用方法 getUTCMinutes()，以检索 now 创建时的 UTC 分钟值。接下来，再创建一个新 Date 对象 before，再调用 setUTCMinutes()（其中的 minute 参数设置为 0），并再次调用 getUTCMinutes()，以检索新设置的分钟值。
var now:Date = new Date(); trace(now); trace(now.getUTCMinutes()); var before:Date = new Date(now.setUTCMinutes(0)); trace(before); trace(before.getUTCMinutes());
setUTCMonth | () | 方法 |
AS3 function setUTCMonth(month:Number, day:Number):Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照通用时间 (UTC) 设置月份值及（可选）日期值，并以毫秒为单位返回新时间。调用此方法不会修改其他字段，但如果因调用该方法而导致星期值发生变化，则 Date.getUTCDay() 和 Date.getDay() 方法可能会报告一个新值。
参数
month:Number — 0（一月）到 11（十二月）之间的一个整数。
| |
day:Number — 1 到 31 之间的一个整数。
|
Number — 新时间，以毫秒为单位。
|
相关 API 元素
示例 ( 如何使用本示例 )
下例创建一个新的 Array 对象
UTCMonthLabels，包含元素 January 到 December，并创建一个不带参数的新 UTCMonth 对象 now。然后，调用方法 getUTCMonth()，以检索 now 创建时的 UTC 月份值。接着调用 setUTCMonth()（其中的 month 参数设置为 0），然后再次调用 getUTCMonth()，以检索新设置的月份值。
var UTCMonthLabels:Array = new Array("January",
"February",
"March",
"April",
"May",
"June",
"July",
"August",
"September",
"October",
"November",
"December");
var now:Date = new Date();
trace(now.getUTCMonth());
trace(UTCMonthLabels[now.getUTCMonth()]);
now.setUTCUTCMonth(0);
trace(now.getUTCMonth()); // 0
trace(UTCMonthLabels[now.getUTCMonth()]); // January
setUTCSeconds | () | 方法 |
AS3 function setUTCSeconds(second:Number, millisecond:Number):Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照通用时间 (UTC) 设置秒值以及（可选）毫秒值，并以毫秒为单位返回新时间。
参数
second:Number — 0 到 59 之间的一个整数。
| |
millisecond:Number — 0 到 999 之间的一个整数。
|
Number — 新时间，以毫秒为单位。
|
示例 ( 如何使用本示例 )
以下示例创建一个不带参数的新 Date 对象
now。然后，调用方法 getUTCSeconds()，以检索 now 创建时的秒值。然后，调用 setUTCSeconds()（其中的 second 参数设置为 0），并再次调用 getUTCSeconds()，以检索新设置的秒值。
var now:Date = new Date(); trace(now.getUTCSeconds()); now.setUTCSeconds(0); trace(now.getUTCSeconds()); // 0
toDateString | () | 方法 |
AS3 function toDateString():String| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
仅返回星期值和日期值的字符串表示形式，而不返回时间或时区。对比下列方法：
Date.toTimeString()仅返回时间和时区Date.toString()不仅返回星期值和日期值，还返回时间和时区。
String — 仅返回星期值和日期值的 String 表示形式。
|
相关 API 元素
示例 ( 如何使用本示例 )
下例创建一个不带参数的新 Date 对象
now，然后调用以下方法（在 trace() 语句中）
toString：显示now创建之时now的所有参数。toDateString()：显示now创建时的day、month和year参数。
var now:Date = new Date(); trace(now); trace(now.toDateString());
toJSON | () | 方法 |
AS3 function toJSON(k:String):*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 11, AIR 3, Flash Lite 4 |
提供一种可覆盖的方法，用于在 Date 对象中自定义值的 JSON 编码。
JSON.stringify() 方法在其遍历的每个对象上寻找 toJSON() 方法。如果找到 toJSON() 方法，JSON.stringify() 会为其遇到的每个值调用该方法，传入与值配对的密钥。
Date 提供了 toJSON() 的默认实现，该实现返回 Date.toString() 的输出。希望以任何其他格式将 Date 对象导出到 JSON 的客户端可提供其自己的实现。通过重新定义类原型中的 toJSON() 方法可执行此操作。
toJSON() 方法可返回任何类型的值。如果返回一个对象，则 stringify() 会递归到该对象中。如果 toJSON() 返回一个字符串，则 stringify() 不会递归并继续其遍历。
参数
k:String — JSON.stringify() 在遍历此对象时遇到的密钥/值对的密钥
|
* — 对象的 Date.toString() 值。
|
相关 API 元素
object
Object.prototype
Object.prototype
toLocaleDateString | () | 方法 |
toLocaleString | () | 方法 |
toLocaleTimeString | () | 方法 |
toString | () | 方法 |
AS3 function toString():String| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
返回星期值、日期值、时间和时区的字符串表示形式。输出的日期格式为：
Day Mon Date HH:MM:SS TZD YYYY
例如：
Wed Apr 12 15:30:17 GMT-0700 2006
返回String — Date 对象的字符串表示形式。
|
示例 ( 如何使用本示例 )
下面的示例创建一个不带参数的新 Date 对象
now，然后调用 toString（在 trace() 语句中），以显示 now 创建时 now 的所有参数。
var now:Date = new Date(); trace(now);
toTimeString | () | 方法 |
toUTCString | () | 方法 |
UTC | () | 方法 |
public static function UTC(year:Number, month:Number, date:Number = 1, hour:Number = 0, minute:Number = 0, second:Number = 0, millisecond:Number = 0):Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
返回 1970 年 1 月 1 日午夜（通用时间）与参数中指定的时间之间相差的毫秒数。该方法使用通用时间，而 Date 构造函数使用本地时间。
如果要将一个 UTC 日期传递给 Date 类构造函数，则该方法很有用。因为 Date 类构造函数接受参数形式的毫秒偏移，所以可以使用 Date.UTC() 方法将 UTC 日期转换成相应的毫秒偏移，然后将该偏移作为参数发送给 Date 类构造函数：
参数
year:Number — 表示年份的四位数整数（例如，2000）。
| |
month:Number — 0（一月）到 11（十二月）之间的一个整数。
| |
date:Number (default = 1) | |
hour:Number (default = 0) | |
minute:Number (default = 0) | |
second:Number (default = 0) | |
millisecond:Number (default = 0) |
Number — 自 1970 年 1 月 1 日起的毫秒数以及指定日期和时间。
|
示例 ( 如何使用本示例 )
下例创建一个新的 Date 对象
someBirthday，包含参数 year (1974)、month (10 = November)、day (30)、hour (1) 和 minute (20)，这些参数使用本地时间。然后，调用 UTC()（在 setTime() 方法中），以将上述参数重置为通用时间。
var someBirthday:Date = new Date(1974, 10, 30, 15, 20); trace(someBirthday.toString()); someBirthday.setTime(Date.UTC(1974, 10, 30, 15, 20)); trace(someBirthday.toString());
valueOf | () | 方法 |
AS3 function valueOf():Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
按照通用时间返回 Date 对象中自 1970 年 1 月 1 日午夜以来的毫秒数。
Number — Date 对象表示的自 1970 年 1 月 1 日以来的毫秒数。
|
示例 ( 如何使用本示例 )
下面的示例创建一个不带参数的新 Date 对象
now。然后，调用 getTime() 方法，以检索 now 创建时与 1970 年 1 月 1 日午夜之间的毫秒数，接着调用 valueOf()，以检索相同的内容。
var now:Date = new Date(); trace(now.getTime()); trace(now.valueOf());
示例 如何使用本示例
DateExample.as
下面的示例演示
Date() 函数的各种用法，可为下列变量赋值：
myDate1调用Date()，调用时不带参数，这将myDate1设置为当前日期和时间（根据当前系统日期和时间）。myDate2调用Date()，调用时将year(2000)、month (0= January) 和day(1) 参数传递给该方法。myDate3调用Date()，调用时将year(65= 1965)、month(2= March)、day(6)、hour(9)、minute(30)、second(15) 和millisecond-+ (0) 作为参数传递。myDate4调用Date()，后者带有表示 GMT 时间 1970 年 1 月 1 日 0:00:00 之前（因该值为负）的毫秒数的时间值。
package {
import flash.display.Sprite;
public class DateExample extends Sprite{
public function DateExample() {
var myDate1:Date = new Date();
trace(myDate1); // [NOW]
var myDate2:Date = new Date(2000, 0, 1);
trace(myDate2); // Sat Jan 1 00:00:00 GMT-0800 2000
var myDate3:Date = new Date(65, 2, 6, 9, 30, 15, 0);
trace(myDate3); // Sat Mar 6 09:30:15 GMT-0800 1965
var myDate4:Date = new Date(-14159025000);
trace(myDate4); // Sun Jul 20 19:56:15 GMT-0700 1969
}
}
}
Tue Jun 12 2018, 11:04 AM Z