Date

Date    操作日期和时间的对象

构造函数：

new Date()

　　把创建的Date对象设置为当前的日期和时间。

new Date(milliseconds)

　　milliseconds是一个数字，它将被作为日期的内部数字表示，其单位是ms，和方法getTime()的返回值一样。　

new Date(datestring)

　　datestring是一个字符串，它是日期的字符串表示，其格式就是方法Date.parse()接受的格式。

new Date(year,month,day,hours,minutes,seconds,ms)

　　传递给该构造函数的是2-7个数字，它们分别指定了日期和时间的各个字段。除了前两个字段（年和月）外，其它所有字段都是选用的。

注意：声明这些日期和时间的字段使用的是本地时间，而不是UTC时间。

Date()还可以作为普通函数被调用，而不带有运算符new。以这种方式调用时，Date()将忽略传递给它的所有参数，返回当前日期和时间的字符串表示。

参数：
milliseconds

　　期望的日期距1970年1月1日午夜（UTC）的ms数。例如，假定传递的参数值为5000，那么创建的Date对象代表日期的就是1970年1月1日午夜过5s。

datestring

　　一个字符串，声明了日期，也可以同时声明时间。这个字符串的格式应该是Date.parse()能接受的。

year

　　年份，一个四位数。为了与早起的JavaScript实现兼容，如果它的值在0~99之间，则给它加上1900。

month

　　月份，0（代表一月）到11（代表12月）之间的一个整数。

day

　　一个月的某一天，1~31之间的一个整数。该参数是选用的。

hours

　　小时，0（午夜）到23（晚上11点）之间的一个整数。该参数是选用的。

minutes

　　分钟，0~59之间的一个整数。该参数是选用的。

seconds

　　秒，0~59之间的一个整数。该参数是选用的。

ms

　　毫秒0~999之间的一个整数。该参数是选用的。

方法：

Date 对象没有可以直接读写的属性。所有对日期和时间的访问都是通过方法执行的。Date对象的大多数方法采用两种格式，一种是使用本地时间进行操作，另一种是 使用世界时间（UTC或GMT）进行操作。如果方法的名称中有“UTC”，它将使用世界时间进行操作，下面将这些方法对列在一起。例 如：get[UTC]Day指方法getDay()和getUTCDay()。只有Date对象才能调用Date方法，如果用其它类型的对象调用这些方 法，将抛出异常TypeError。

 

get[UTC]Date()

返回Date对象所代表的月中的某一天，采用本地时间或世界时间。

摘要：date.getDate()

返回值：1~31之间的一个整数。

例子：

var date = new Date();
document.write(date.getDate());    //  23
document.write(date.getUTCDate()); //  23

get[UTC]Day()

返回Date对象所代表的一周中的某一天，采用本地时间或世界时间。

摘要：date.getDay()

返回值：0（周日）到6（周六）之间的一个整数。

例子：

var date = new Date();
document.write(date.getDay());    //  1
document.write(date.getUTCDay()); //  1

get[UTC]FullYear()

返回日期中的年份，用四位数表示，采用本地时间或世界时间。

摘要：date.getFullYear()

返回值：返回值是一个四位数，表示包括世纪值在内的完整年份，而不是两位数的缩写形式。

例子：

var date = new Date();
document.write(date.getFullYear());    //  2012
document.write(date.getUTCFullYear()); //  2012

get[UTC]Hours()

返回Date对象的小时字段，采用本地时间或世界时间。

摘要：date.getHours()

返回值：返回值是0（午夜）到23（晚上11点）之间的一个整数。

例子：

var date = new Date();
document.write(date.getHours());    //  11
document.write("<br>");
document.write(date.getUTCHours()); //  3

get[UTC]Milliseconds()

返回Date对象的毫秒字段，采用本地时间或世界时间。

摘要：date.getMilliseconds()

返回值:date的毫秒字段。

例子：

var date = new Date();
document.write(date.getMilliseconds());      //619
document.write("<br>");
document.write(date.getUTCMilliseconds());  //619

get[UTC]Minutes()

返回Date对象的分钟字段，采用本地时间或世界时间。

摘要：date.getMinutes()

返回值：指定Date对象的分钟字段。在0-59之间。

例子：

var date = new Date();
document.write(date.getMinutes());    //59
document.write("<br>");
document.write(date.getUTCMinutes()); //59

get[UTC]Month()

返回Date对象指定的月份字段，采用本地时间或世界时间。

摘要:date.getMinutes()

返回值：返回值在0（一月）到11（十二月）之间。

例子：

var date = new Date();
document.write(date.getMonth());    //3
document.write("<br>");
document.write(date.getUTCMonth()); //3

get[UTC]Seconds()

返回Date对象的秒字段，采用本地时间或世界时间。

摘要：date.getSeconds()

返回值：0~59之间

例子：

var date = new Date();
document.write(date.getSeconds());    //29
document.write("<br>");
document.write(date.getUTCSeconds()); //29

getTime()

返回Date对象的内部毫秒数，注意，该值独立于时区，所以没有单独的getUTCtime()方法。

摘要：date.getTime()

返回值：指定的Date对象date的毫秒数，也就是date指定的日期和时间距1970年1月1日午夜（GMT）之间的毫秒数。

例子：

var date = new Date();
document.write(date.getTime());    //1335240631702

 getTimezoneOffset()

返回这个日期的本地时间和UTC表示之间的时差，以分钟为单位。注意，是否是夏令时或在指定的日期中夏令时是否有效，将决定该方法的返回值。

摘要：date.getTimezoneOffset()

返回值：本地时间与GMT时间之间的时差，以分钟为单位。

描述：getTimezoneOffset()返回本地时间与GMT时间或UTC时间之间相差的分钟数，实际上该函数告诉了你运行JavaScript代码的时区，以及指定的时间是否是夏令时。返回值以分钟计，而不是以小时，原因是某些国家所占有的时区甚至不到一个小时的间隔。

例子：

var date = new Date();
document.write(date.getTimezoneOffset());    //-480

getYear()

返回Date对象的年份(世界时)。一般不使用这种方法，推荐使用的方法getFullYear();

摘要：date.getYear()

返回值：指定Date对象date的年份字段减去1900。

描述：从ECMAScript v3起，JavaScript的实现就不再要求使用该函数，而使用getFullYear()函数代替它。

set[UTC]Date()

设置Date对象中月的某一天，采用本地时间或世界时间。

摘要：date.setDate(day_of_month)

参数：

day_of_month    1~31之间的整数，作为Date的月中某一天字段的新值（本地时间或世界时间）。

返回值：

调整过的日期的毫秒数。在ECMAScript标准化之前，该方法什么都不返回。

例子：

var date = new Date();
document.write(date.setDate(24));    // 1335247971179
document.write("<br>");
document.write(date.setUTCDate(24));    // 1335247971179

set[UTC]FullYear()

设置Date对象的年份字段（月份和天数字段可选），采用本地时间或世界时间。

摘要：

date.setFullYear(year)

date.setFullYear(year,month)

date.setFulYear(year,month,day)

参数：

year:  该参数应该是一个完整的年份，如：2012，而不是年份的缩写，如12。

month: 可选的整数。在0~11之间，用作date的月份字段的新值。

day: 可选的整数。在1~31之间，用作date的天数字段的新值。

返回值：调整过的日期的毫秒数。

例子：

var date = new Date();
document.write(date.setFullYear(2012));    // 1335249639070
document.write("<br>");
document.write(date.setFullYear(2012,5));    // 1340520039070
document.write("<br>");
document.write(date.setFullYear(2012,5,28));    // 1340865639070

set[UTC]Hours()

设置Date对象的小时字段（分钟、秒和毫秒字段选用），采用本地时间或世界时间。

摘要：

date.setHours(hours)

date.setHours(hours,minutes)

date.setHours(hours,minutes,seconds)

date.setHours(hours,minutes,seconds,millis)

参数：

hours: 0~23之间的整数，用作date的小时字段的新值。

minutes: 可选的整数，在0~59之间。用作date的分钟字段的新值。ECMAScript标准化之前，不支持该参数。

seconds: 可选的整数，0~59之间。用作date的秒字段的新值。ECMAScript标准化之前，不支持该参数。

millis: 可选的整数，在0~999之间，用作date的毫秒字段的新值。ECMAScript标准化之前，不支持该参数。

返回值：

调整过的日期的毫秒数。ECMAScript标准化之前，该方法不返回值。

set[UTC]Milliseconds()

设置Date对象的毫秒字段。采用本地时间或世界时间。

摘要：

date.setMilliseconds(millis)

参数：

millis: 用于设置date的毫秒字段。是0~999之间的整数。

返回值：调整过的日期的毫秒表示。

set[UTC]Minutes()

设置Date对象的分钟字段（秒和毫秒字段选用），采用本地时间或世界时间。

摘要：

date.setMinutes(minutes)

date.setMinutes(minutes,seconds)

date.setMinutes(minutes,seconds,millis)

参数：

minutes: 用于设置的date的分钟字段，0~59。

seconds: 可选的整数。0~59之间，用作date的秒字段的新值，ECMAScript标准化之前，不支持该参数。

millis: 可选整数。0~999之间，用作date毫秒字段的新值。ECMAScript标准化之前，不支持该参数。

返回值：

调整过的日期的毫秒表示。ECMAScript标准化之前，该方法不返回值。

set[UTC]Minutes()  

设置Date对象的分钟字段（秒和毫秒字段选用）。采用本地时间或世界时间。

摘要：

date.setMinutes(minutes)

date.setMinutes(minutes,seconds)

date.setMinutes(minutes,seconds,millis)

参数：

minutes: 0~59的整数。用于设置Date对象date的分钟字段。

seconds: 可选的整数，在0~59之间，用作date的秒字段的新值。ECMAScript标准化之前，不支持该参数。

millis: 可选的整数，在0~999之间，用作date毫秒字段的新值。ECMAScript标准化之前，不支持该参数。

返回值：

调整过的日期的毫秒数。ECMAScript标准化之前，该方法不返回值。

set[UTC]Month()

设置date对象的月份字段（一个月的天数字段选用），采用本地时间或世界时间。

摘要：

date.setMonth(month)

date.setMonth(month,day)

参数：

month: 0（一月）到11（十二月）之间的整数，用于设置Date对象date的月份字段。

day: 可选的整数，在1~31之间，用作date的天数字段的新值。ECMAScript标准化之前，不支持该参数。

返回值：

调整过的日期的毫秒表示。ECMAScript标准化之前，该方法不返回值。

set[UTC]Seconds

设置Date对象的秒字段（毫秒字段选用），采用本地时间或世界时。

摘要：

date.setSeconds(seconds)

date.setSeconds(seconds,millis)

参数：

seconds: 0~59之间的整数，用于设置Date对象date的秒字段。

millis: 可选的整数，在0~999之间，用作date的毫秒字段的新值，ECMAScript标准化之前，不支持该参数。

返回值：

调整过的日期的毫秒表示。ECMAScript标准化之前，该方法不返回值。

setTime()

使用毫秒的形式设置Date对象的各个字段。

摘要：

date.setTime(milliseconds)

参数：

milliseconds: 要设置的日期和时间距GMT时间1970年1月1日午夜之间的毫秒数。这种类型的毫秒值可以传递给Date()构造函数，可以通过调用Date.UTC()和Date.parse()方法获得该值。以豪秒形式表示日期可以使它独立于时区。

返回值：

参数milliseconds.ECMAScript标准化之前，该方法不返回值。

setYear()

设置Date对象的年份字段。不赞成使用该方法，推荐使用setFullYear()。

toDateString()

返回日期的日期部分的字符串表示，采用本地时间。

摘要：

date.toDateString()

返回值：

date的日期部分的字符串表示。

例子：

var date = new Date();
document.write(date.toDateString());  //   Thu Apr 26 2012

toGMTString()

将Date对象转换成一个字符串，采用GMT时间区。该方法被反对使用，推荐使用的方法是toUTCString()。

toLocaleDateString()

返回表示日期的日期部分的字符串，采用地方日期，使用地方日期的格式化规约。

摘要：

date.toLocalDateString()

返回值：

date的日期部分的字符串表示。

例子：

var date = new Date();
document.write(date.toLocaleDateString());  //   2012年4月26日

toLocaleString()

将Date对象转换成一个字符串。采用本地时间和地方日期的格式化规约。

摘要：date.toLocaleString()

返回：Date对象date指定的日期和时间的字符串表示。该日期和时间用本地时间区表示，并根据本地规则格式化。

例子：

var date = new Date();
document.write(date.toLocaleString());  //   2012年4月26日 10:44:39

toLocaleTimeString()

返回日期的时间部分的字符串表示，采用本地时间，使用本地的格式化规约。

摘要：date.toLocaleTimeString()

返回值：

date的时间部分的字符串表示，以本地时间区表示，并根据本地规则格式化。

例子：

var date = new Date();
document.write(date.toLocaleTimeString());  //   10:46:57

toString()

将Date对象转换成一个字符串，采用本地时间。

摘要：date.toString()

返回值：date的字符串表示。

例子：

var date = new Date();
document.write(date.toString());  //   Thu Apr 26 2012 10:37:42 GMT+0800

toTimeString()

返回日期的时间部分的字符串表示，采用本地时间。

摘要： date.toTimeString()

返回值：

date的时间部分的字符串表示，由实现决定，以本地时间表示。

例子：

var date = new Date();
document.write(date.toTimeString());  //   10:48:49 GMT+0800

toUTCString()

将Date对象转换成一个字符串，采用世界时。

摘要： date.toUTCString()

返回值：返回一个特定于实现的字符串，这个字符串用世界时表示日期。

例子：

var date = new Date();
document.write(date.toUTCString());  //   Thu, 26 Apr 2012 02:50:38 GMT

valueOf()

将Date对象转换成它的内部毫秒格式。

摘要： date.valueOf()

返回值： date的毫秒表示。返回值和方法Date.getTime()返回的值相等。

例子：

var date = new Date();
document.write(date.valueOf());  //   1335408864136
document.write("<br>"); 
document.write(date.getTime());  //   1335408864136

静态方法：

这两个方法由构造函数Date()自身调用，而不是由date对象调用。

Date.parse()

解析日期和时间的字符串表示，返回它的内部毫秒表示。

摘要： Date.parse(date)

参数：

date ： 含有要解析的日期和时间的字符串。

返回值：指定的日期和时间距1970年1月1日午夜（GMT）之间的毫秒数。

例子：

var d = Date.parse("Jul 8, 2005")
document.write(d);   //1120752000000 

Date.UTC()

返回指定的UTC日期和时间的毫秒表示。

摘要：

Date.UTC(year,month,day,hours,minutes,seconds,ms)

参数：

year:   四位数表示的年份值。如果参数在0~99之间，它将加上1900，作为1900~1999之间的年份处理。

month: 月份值，是0（1月）到11（十二月）之间的整数。

day:  一个月中的某一天，是1~31之间的整数。该参数是选用的。

hours: 小时值，0~23之间的整数。该参数是选用的。

minutes:  分钟值，0~59之间的整数。该参数是选用的。

seconds: 秒值。0~59之间的整数。该参数是选用的。

ms:  毫秒值。0~999之间的整数。该参数是选用的。

返回值： 指定的世界时的毫秒表示。简而言之，该方法返回指定的时间距GMT时间1970年1月1日午夜的毫秒数。