javascript(JS) 时间函数

Date (对象)
　　Date 对象能够使你获得相对于国际标准时间（格林威治标准时间，现在被称为 UTC-Universal Coordinated Time）或者是 Flash 播放器正运行的操作系统的时间和日期。要使用Date对象的方法，你就必须先创建一个Date对象的实体（Instance）。

　　Date 对象必须使用 Flash 5 或以后版本的播放器。

　　Date 对象的方法并不是静态的，但是在使用时却可以应用于所指定的单独实体。

　　Date 对象的方法简介：

　　·getDate　　　　　　｜　根据本地时间获取当前日期(本月的几号)
　　·getDay　　 　　　　｜　根据本地时间获取今天是星期几(0-Sunday,1-Monday...)
　　·getFullYear　　　　｜　根据本地时间获取当前年份(四位数字)
　　·getHours　　 　　　｜　根据本地时间获取当前小时数(24小时制,0-23)
　　·getMilliseconds　　｜　根据本地时间获取当前毫秒数
　　·getMinutes　　　 　｜　根据本地时间获取当前分钟数
　　·getMonth　　　　 　｜　根据本地时间获取当前月份(注意从0开始:0-Jan,1-Feb...)
　　·getSeconds　　　 　｜　根据本地时间获取当前秒数
　　·getTime　　　　　　｜　获取UTC格式的从1970.1.1 0:00以来的毫秒数
　　·getTimezoneOffset　｜　获取当前时间和UTC格式的偏移值(以分钟为单位)
　　·getUTCDate　　　　 ｜　获取UTC格式的当前日期(本月的几号)
　　·getUTCDay　　　　　｜　获取UTC格式的今天是星期几(0-Sunday,1-Monday...)
　　·getUTCFullYear　　 ｜　获取UTC格式的当前年份(四位数字)
　　·getUTCHours　　　　｜　获取UTC格式的当前小时数(24小时制,0-23)
　　·getUTCMilliseconds ｜　获取UTC格式的当前毫秒数
　　·getUTCMinutes　　　｜　获取UTC格式的当前分钟数
　　·getUTCMonth　　　　｜　获取UTC格式的当前月份(注意从0开始:0-Jan,1-Feb...)
　　·getUTCSeconds　　　｜　获取UTC格式的当前秒数
　　·getYear　　　　　　｜　根据本地时间获取当前缩写年份(当前年份减去1900)
　　·setDate　　　　　　｜　设置当前日期(本月的几号)
　　·setFullYear　　　　｜　设置当前年份(四位数字)
　　·setHours　　　　　 ｜　设置当前小时数(24小时制,0-23)
　　·setMilliseconds　　｜　设置当前毫秒数
　　·setMinutes　　　　 ｜　设置当前分钟数
　　·setMonth　　　　　 ｜　设置当前月份(注意从0开始:0-Jan,1-Feb...)

　　·setSeconds　　　　 ｜　设置当前秒数
　　·setTime　　　　　　｜　设置UTC格式的从1970.1.1 0:00以来的毫秒数
　　·setUTCDate　　　　 ｜　设置UTC格式的当前日期(本月的几号)
　　·setUTCFullYear　　 ｜　设置UTC格式的当前年份(四位数字)
　　·setUTCHours　　　　｜　设置UTC格式的当前小时数(24小时制,0-23)
　　·setUTCMilliseconds ｜　设置UTC格式的当前毫秒数
　　·setUTCMinutes　　　｜　设置UTC格式的当前分钟数
　　·setUTCMonth　　　　｜　设置UTC格式的当前月份(注意从0开始:0-Jan,1-Feb...)
　　·setUTCSeconds　　　｜　设置UTC格式的当前秒数
　　·setYear　　　　　　｜　设置当前缩写年份(当前年份减去1900)
　　·toString　　　　　 ｜　将日期时间值转换成日期/时间形式的字符串值
　　·Date.UTC　　　　　 ｜　返回指定的UTC格式日期时间的固定时间值

创建新的 Date 对象

　　语法：
　　　new Date();
　　　new Date(year [, month [, date [, hour [, minute [, second [, millisecond ]]]]]] );
　　参数：
　　　year 　　　　是一个 0 到 99 之间的整数，对应于 1900 到 1999 年，或者为四位数字指定确定的年份；

　　　month　　　　是一个 0 (一月) 到 11 (十二月) 之间的整数，这个参数是可选的；
　　　date　 　　　是一个 1 到 31 之间的整数，这个参数是可选的；
　　　hour 　　　　是一个 0 (0:00am) 到 23 (11:00pm) 之间的整数，这个参数是可选的；
　　　minute 　　　是一个 0 到 59 之间的整数，这个参数是可选的；
　　　second 　　　是一个 0 到 59 之间的整数，这个参数是可选的；
　　　millisecond　是一个 0 到 999 之间的整数，这个参数是可选的；
　　注释：
　　　对象。新建一个 Date 对象。
　　播放器支持：
　　　Flash 5 或以后的版本。
　　例子：
　　　下面是获得当前日期和时间的例子：
　　　　now = new Date();
　　　下面创建一个关于国庆节的 Date 对象的例子：
　　　　national_day = new Date (49, 10, 1);
　　　下面是新建一个 Date 对象后，利用 Date 对象的 getMonth、getDate、和 getFullYear方法获取时间，然后在动态文本框中输出的例子。
　　　　myDate = new Date();
　　　　dateTextField = (mydate.getMonth() + / + myDate.getDate() + / + mydate.getFullYear());

Date > Date.getDate
Date.getDate

　　语法：myDate.getDate();
　　参数：无
　　注释：
　　　方法。根据本地时间获取当前日期(本月的几号)，返回值是 1 到 31 之间的一个整数。
　　播放器支持：Flash 5 或以后版本。

Date > Date.getDay
Date.getDay

　　语法：myDate.getDay();
　　参数：无
　　注释：
　　　方法。根据本地时间获取今天是星期几(0-星期日，1-星期一...)。本地时间由 Flash 播放器所运行的操作系统决定。
　　播放器支持：Flash 5 或以后版本。

Date > Date.getFullYear
Date.getFullYear

　　语法：myDate.getFullYear();
　　参数：无
　　注释：
　　　方法。根据本地时间获取当前年份(四位数字，例如 2000)。本地时间由 Flash 播放器所运行的操作系统决定。
　　播放器支持：Flash 5 或以后版本。
　　例子：
　　　下面的例子新建了一个 Date 对象，然后在输出窗口输出用 getFullYear 方法获得的年份：
　　　myDate = new Date();
　　　trace(myDate.getFullYear());

Date > Date.getHours
Date.getHours

　　语法：myDate.getHours();
　　参数：无
　　注释：

　　　方法。根据本地时间获取当前小时数(24小时制，返回值为0-23之间的整数)。本地时间由 Flash 播放器所运行的操作系统决定。
　　播放器支持：Flash 5 或以后版本。

Date > Date.getMilliseconds
Date.getMilliseconds

　　语法：myDate.getMilliseconds();
　　参数：无
　　注释：
　　　方法。根据本地时间获取当前毫秒数(返回值是 0 到 999 之间的一个整数)。本地时间由 Flash 播放器所运行的操作系统决定。
　　播放器支持：Flash 5 或以后版本。

Date > Date.getMinutes
Date.getMinutes

　　语法：myDate.getMinutes();
　　参数：无
　　注释：
　　　方法。根据本地时间获取当前分钟数(返回值是 0 到 59 之间的一个整数)。本地时间由 Flash 播放器所运行的操作系统决定。
　　播放器支持：Flash 5 或以后版本。

Date > Date.getMonth
Date.getMonth

　　语法：myDate.getMonth();
　　参数：无
　　注释：
　　　方法。根据本地时间获取当前月份(注意从0开始:0-一月,1-二月...)。本地时间由 Flash 播放器所运行的操作系统决定。
　　播放器支持：Flash 5 或以后版本。

Date > Date.getSeconds
Date.getSeconds

　　语法：myDate.getSeconds();
　　参数：无
　　注释：
　　　方法。根据本地时间获取当前秒数(返回值是 0 到 59 之间的一个整数)。本地时间由 Flash 播放器所运行的操作系统决定。
　　播放器支持：Flash 5 或以后版本。

Date > Date.getTime
Date.getTime

　　语法：myDate.getTime();
　　参数：无
　　注释：
　　　方法。按UTC格式返回从1970年1月1日0:00am起到现在的毫秒数。使用这个方法可以描述不同时区里的同一瞬间的时间。
　　播放器支持：Flash 5 或以后版本。

Date > Date.getTimezoneOffset
Date.getTimezoneOffset

　　语法：mydate.getTimezoneOffset();
　　参数：无
　　注释：
　　　方法。获取当前时间和UTC格式的偏移值(以分钟为单位)。
　　播放器支持：Flash 5 或以后版本。
　　例子：
　　　下面的例子将返回北京时间与UTC时间之间的偏移值。
　　　new Date().getTimezoneOffset();
　　　结果如下：
　　　480 (8 小时 * 60 分钟/小时 = 480 分钟)

Date > Date.getUTCDate
Date.getUTCDate

　　语法：myDate.getUTCDate();
　　参数：无
　　注释：
　　　方法。获取UTC格式的当前日期(本月的几号)。
　　播放器支持：Flash 5 或以后版本。

Date > Date.getUTCDay
Date.getUTCDay

　　语法：myDate.getUTCDate();
　　参数：无
　　注释：
　　　方法。获取UTC格式的今天是星期几(0-星期日，1-星期一...)。
　　播放器支持：Flash 5 或以后版本。

Date > Date.getUTCFullYear
Date.getUTCFullYear

　　语法：myDate.getUTCFullYear();
　　参数：无
　　注释：
　　　方法。获取UTC格式的当前年份(四位数字)。
　　播放器支持：Flash 5 或以后版本。

Date > Date.getUTCHours
Date.getUTCHours

　　语法：myDate.getUTCHours();
　　参数：无
　　注释：
　　　方法。获取UTC格式的当前小时数(24小时制,返回值为0-23之间的一个整数)。
　　播放器支持：Flash 5 或以后版本。

Date > Date.getUTCMilliseconds
Date.getUTCMilliseconds

　　语法：myDate.getUTCMilliseconds();
　　参数：无
　　注释：
　　　方法。获取UTC格式的当前毫秒数(返回值是 0 到 999 之间的一个整数)。
　　播放器支持：Flash 5 或以后版本。

Date > Date.getUTCMinutes
Date.getUTCMinutes

　　语法：myDate.getUTCMinutes();
　　参数：无
　　注释：
　　　方法。获取UTC格式的当前分钟数(返回值是 0 到 59 之间的一个整数)。
　　播放器支持：Flash 5 或以后版本。

Date > Date.getUTCMonth
Date.getUTCMonth

　　语法：myDate.getUTCMonth();
　　参数：无
　　注释：
　　　方法。获取UTC格式的当前月份(注意从0开始:0-一月,1-二月...)。
　　播放器支持：Flash 5 或以后版本。

Date > Date.getUTCSeconds
Date.getUTCSeconds

　　语法：myDate.getUTCSeconds();
　　参数：无
　　注释：
　　　方法。获取UTC格式的当前秒数(返回值是 0 到 59 之间的一个整数)。
　　播放器支持：Flash 5 或以后版本。

Date > Date.getYear
Date.getYear

　　语法：myDate.getYear();
　　参数：无
　　注释：
　　　方法。根据本地时间获取当前缩写年份(当前年份减去1900)。本地时间由 Flash 播放器所运行的操作系统决定。例如 2000 年用100来表示。
　　播放器支持：Flash 5 或以后版本。

Date > Date.setDate
Date.setDate

　　语法：myDate.setDate(date);
　　参数：date 为 1 到 31 之间的一个整数。
　　注释：
　　　方法。根据本地时间设置当前日期(本月的几号)。本地时间由 Flash 播放器所运行的操作系统决定。
　　播放器支持：Flash 5 或以后版本。

Date > Date.setFullYear
Date.setFullYear

　　语法：myDate.setFullYear(year [, month [, date]] );
　　参数：
　　　year 指定的四位整数代表指定年份，二位数字并不代表年份，如99不表示1999，只表示公元99年
　　　month 是一个从 0 (一月) 到 11 (十二月) 之间的整数，这个参数是可选的。
　　　date 是一个从 1 到 31 之间的整数，这个参数是可选的。
　　注释：
　　　方法。根据本地时间设定年份。如果设定了 month 和 date 参数，将同时设定月份和日期。本地时间由 Flash 播放器所运行的操作系统决定。设定之后 getUTCDay 和 getDay 方法所获得的值将出现相应的变化。
　　播放器支持：Flash 5 或以后版本。

Date > Date.setHours
Date.setHours

　　语法：myDate.setHours(hour);
　　参数：hour 是一个从 0 (0:00am) 到 23 (11:00pm) 之间的整数。
　　注释：
　　　方法。根据本地时间设置当前小时数。本地时间由 Flash 播放器所运行的操作系统决定。
　　播放器支持：Flash 5 或以后版本。

Date > Date.setMilliseconds
Date.setMilliseconds

　　语法：myDate.setMilliseconds(millisecond);
　　参数：millisecond 是一个从 0 到 999 之间的整数。
　　注释：
　　　方法。根据本地时间设置当前毫秒数。本地时间由 Flash 播放器所运行的操作系统决定。
　　播放器支持：Flash 5 或以后版本。

Date > Date.setMinutes
Date.setMinutes

　　语法：myDate.setMinutes(minute);
　　参数：minute 是一个从 0 到 59 之间的整数。
　　注释：
　　　方法。根据本地时间设置当前分钟数。本地时间由 Flash 播放器所运行的操作系统决定。
　　播放器支持：Flash 5 或以后版本。

Date > Date.setMonth
Date.setMonth

　　语法：myDate.setMonth(month [, date ]);
　　参数：
　　　month 是一个从 0 (一月) 到 11 (十二月)之间的整数
　　　date 是一个从 1 到 31 之间的整数，这个参数是可选的。
　　注释：
　　　方法。根据本地时间设置当前月份数，如果选用了 date 参数，将同时设定日期。本地时间由 Flash 播放器所运行的操作系统决定。

　　播放器支持：Flash 5 或以后版本。

Date > Date.setSeconds
Date.setSeconds

　　语法：myDate.setSeconds(second);
　　参数：second 是一个从 0 到 59 之间的整数。
　　注释：
　　　方法。根据本地时间设置当前秒数。本地时间由 Flash 播放器所运行的操作系统决定。
　　播放器支持：Flash 5 或以后版本。

Date > Date.setTime
Date.setTime

　　语法：myDate.setTime(millisecond);
　　参数：millisecond 是一个从 0 到 999 之间的整数。
　　注释：
　　　方法。用毫秒数来设定指定的日期。
　　播放器支持：Flash 5 或以后版本。

Date > Date.setUTCDate
Date.setUTCDate

　　语法：myDate.setUTCDate(date);
　　参数：date 是一个从 1 到 31 之间的整数。
　　注释：
　　　方法。按UTC格式设定日期，使用本方法将不会影响 Date 对象的其他字段的值，但是 getUTCDay 和 getDay 方法会返回日期更改过后相应的新值。
　　播放器支持：Flash 5 或以后版本。

Date > Date.setUTCFullYear
Date.setUTCFullYear

　　语法：myDate.setUTCFullYear(year [, month [, date]]);

　　参数：
　　　year 代表年份的四位整数，如 2000
　　　month 一个从 0 (一月) 到 11 (十二月)之间的整数，可选参数。
　　　date 一个从 1 到 31 之间的整数，可选参数。
　　注释：
　　　方法。按UTC格式设定年份，如果使用了可选参数，还同时设定月份和日期。设定过后 getUTCDay 和 getDay 方法会返回一个相应的新值。
　　播放器支持：Flash 5 或以后版本。

Date > Date.setUTCHours
Date.setUTCHours

　　语法：myDate.setUTCHours(hour [, minute [, second [, millisecond]]]));
　　参数：
　　　hour 是一个从 0 (0:00am) 到 23 (11:00pm)之间的整数。
　　　minute 是一个从 0 到 59 之间的整数，可选参数。
　　　second 是一个从 0 到 59 之间的整数，可选参数。
　　　millisecond 是一个从 0 到 999 之间的整数，可选参数。
　　注释：
　　　方法。设定UTC格式的小时数，如果是用可选参数，同时会设定分钟、秒和毫秒值。
　　播放器支持：Flash 5 或以后版本。

Date > Date.setUTCMilliseconds
Date.setUTCMilliseconds

　　语法：myDate.setUTCMilliseconds(millisecond);
　　参数：millisecond 是一个从 0 到 999 之间的整数。

　　注释：
　　　方法。设定UTC格式的毫秒数。
　　播放器支持：Flash 5 或以后版本。

Date > Date.setUTCMinutes
Date.setUTCMinutes

　　语法：myDate.setUTCMinutes(minute [, second [, millisecond]]));
　　参数：
　　　minute 是一个从 0 到 59 之间的整数，可选参数。
　　　second 是一个从 0 到 59 之间的整数，可选参数。
　　　millisecond 是一个从 0 到 999 之间的整数，可选参数。
　　注释：
　　　方法。设定UTC格式的分钟数，如果是用可选参数，同时会设定秒和毫秒值。
　　播放器支持：Flash 5 或以后版本。

Date > Date.setUTCMonth
Date.setUTCMonth

　　语法：myDate.setUTCMonth(month [, date]);
　　参数：
　　　month 是一个从 0 (一月) 到 11 (十二月)之间的整数
　　　date 是一个从 1 到 31 之间的整数，这个参数是可选的。
　　注释：
　　　方法。设定UTC格式的月份，同时可选设置日期。设定后 getUTCDay 和 getDay 方法会返回相应的新值。
　　播放器支持：Flash 5 或以后版本。

Date > Date.setUTCSeconds
Date.setUTCSeconds

　　语法：myDate.setUTCSeconds(second [, millisecond]));
　　参数：
　　　second 是一个从 0 到 59 之间的整数，可选参数。
　　　millisecond 是一个从 0 到 999 之间的整数，可选参数。
　　注释：
　　　方法。设定UTC格式的秒数，如果是用可选参数，同时会设定毫秒值。
　　播放器支持：Flash 5 或以后版本。

Date > Date.setYear
Date.setYear

　　语法：myDate.setYear(year);
　　参数：year 是一个代表年份的四位整数，如 2000。
　　注释：
　　　方法。根据本地时间设定年份。本地时间由 Flash 播放器所运行的操作系统决定。
　　播放器支持：Flash 5 或以后版本。

Date > Date.toString
Date.toString

　　语法：myDate.toString();
　　参数：无
　　注释：
　　　方法。将日期时间值转换成日期/时间形式的字符串值
　　播放器支持：Flash 5 或以后版本。
　　例子：
　　　下面的例子将国庆节的 national_day 对象输出成可读的字符串：
　　　var national_day = newDate(49, 9, 1, 10, 00);
　　　trace (national_day.toString());
　　　Output (for Pacific Standard Time):
　　结果为：Sat Oct 1 10:00:00 GMT+0800 1949

Date > Date.UTC
Date.UTC

　　语法：Date.UTC(year, month [, date [, hour [, minute [, second [, millisecond ]]]]]);
　　参数：
　　　year 代表年份的四位整数，如 2000
　　　month 一个从 0 (一月) 到 11 (十二月)之间的整数。
　　　date 一个从 1 到 31 之间的整数，可选参数。
　　　hour 是一个从 0 (0:00am) 到 23 (11:00pm)之间的整数。
　　　minute 是一个从 0 到 59 之间的整数，可选参数。
　　　second 是一个从 0 到 59 之间的整数，可选参数。
　　　millisecond 是一个从 0 到 999 之间的整数，可选参数。
　　注释：
　　　方法。返回指定时间距 1970 年 1 月 1 日 0:00am 的毫秒数。这是一个静态的方法，不需要特定的对象。它能够创建一个新的 UTC 格式的 Date 对象，而 new Date() 所创建的是本地时间的 Date 对象。
　　播放器支持：Flash 5 或以后版本。