JavaScript的Date 方法
js中Date 方法
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 或以后版本。