ECMAScript 中的 Date 类型使用 UTC(Coordinated Universal Time,国际协调时间)1970 年 1 月 1 日午夜(零点)开始经过的毫秒数来保存日期。在使用这种数据存储格式的条件下,Date 类型保存的日期能够精确到 1970 年 1 月 1 日之前或之后的 285 616 年。
要创建一个日期对象,使用 new
操作符和 Date
构造函数即可,如下所示:
1 | var now = new Date(); |
在调用 Date
构造函数而不传递参数的情况下,新创建的对象自动获得当前日期和时间。如果想根据特定的日期和时间创建日期对象,必须传入表示该日期的毫秒数(即从 UTC 时间 1970 年 1 月 1 日零点起至该日期止经过的毫秒数)。为了简化这一计算过程,ECMAScript 提供了两个方法:Date.parse()
和 Date.UTC()
。
Date.parse()
方法接收一个表示日期的字符串参数,然后尝试根据这个字符串返回相应日期的毫秒数。ECMA-262 没有定义 Date.parse()
应该支持哪种日期格式,因此这个方法的行为因实现而异,而且通常是因地区而异。
1 | var someDate = new Date(Date.parse("May 25, 2004")); |
如果传入 Date.parse()
方法的字符串不能表示日期,那么它会返回 NaN
。实际上,如果直接表示日期的字符串传递给 Date
构造函数,也会在后台调用 Date.parse()
。
1 | var someDate = new Date("May 25, 2004"); |
Date.UTC()
方法同样也返回表示日期的毫秒数,但它与 Date.parse()
在构建值时使用不同的信息。Date.UTC()
的参数分别是年份、基于 0 的月份(一月是 0,二月是 1,以此类推)、月中的哪一天(1 到 31)、小时数(0 到 23)、分钟、秒以及毫秒数。在这些参数中,只有前两个参数(年和月)是必需的。如果没有提供月中的天数,则假设天数为 1;如果省略其他参数,则统统假设为 0。
1 | // GMT 时间 2000 年 1 月 1 日午夜零时 |
这个例子创建了两个日期对象。第一个对象表示 GMT 时间 2000 年 1 月 1 日午夜零时,传入的值一个是表示年份的 2000,一个是表示月份的 0(1月份)。第二个对象表示 GMT 时间 2005 年 5 月 5 日下午 5:55:55,传入的月份为 4,小时为 17。
如同模仿 Date.parse()
一样,Date
构造函数也会模仿 Date.UTC()
,但有一点明显不同:日期和时间都基于本地时区而非 GMT 来创建。不过,Date
构造函数接收的参数仍然与 Date.UTC()
相同。因此,如果第一个参数是数值,Date
构造函数就会假设该值是日期中的年份,而第二个参数是月份,以此类推。
1 | // 本地时间 2000 年 1 月 1 日午夜零时 |
ES5 添加了 Date.now()
方法,返回表示调用这个方法时的日期和时间的毫秒数。这个方法简化了使用 Date 对象分析代码的工作。
1 | // 取得开始时间 |
支持 Date.now()
方法的浏览器包括 IE9+、Firefox 3+、Safari 3+、Opera 10.5 和 Chrome。在不支持它的浏览器中,使用 + 操作符把 Date 对象转换成字符串,也可以达到同样的目的。
1 | // 取得开始时间 |
1.继承的方法
与其他引用类型一样,Date 类型也重写了 toLocaleString()
、toString()
和 valueOf()
方法;但这些方法返回的值与其他类型中的方法不同。Date 类型的 toLocaleString()
方法会按照与浏览器设置的地区相适应的格式返回日期和事件。而 toString()
方法则通常返回带有时区信息的日期和时间。
这两种方法在不同浏览器中返回的日期和时间格式有很大差别,这些差别仅在调试代码时比较有用,而在显示日期和时间时没有什么价值。
valueOf()
方法不会返回字符串,而是返回日期的毫秒表示。因此,可以方便使用比较操作符(小于或大于)来比较日期值。例如:
1 | var date1 = new Date(2007, 0, 1); // Mon Jan 01 2007 00:00:00 GMT+0800 (中国标准时间) |
由于表示 2007 年 1 月 1 日的毫秒值小于表示 2007 年 2 月 1 日的毫秒值,因此在首先使用小于操作符比较日期时,返回的结果是 true
。这样,为日期的比较提供了极大的方便。
2.日期的格式化方法
Date 类型还有一些专门用于将日期格式化为字符串的方法,这些方法如下:
- toDateString() —— 以特定于实现的格式显示星期几、月、日和年;
- toTimeString() —— 以特定于实现的格式显示时、分、秒和时区;
- toLocaleDateString() —— 以特定于地区的格式显示星期几、月、日和年;
- toLocaleTimeString() —— 以特定于实现的格式显示时、分、秒;
- toUTCString() —— 以特定于实现的格式显示完整的 UTC 日期。
与 toLocaleString()
和 toString()
方法一样,以上这些字符串格式方法的输出也因浏览器而异,没有哪一个方法能够用来在用户界面中显示一致的日期信息。
除了前面的方法,还有一个 toGMTString() 方法,该方法与 toUTCString() 等价,其存在目的在于确保向后兼容。不过,ES 已不推荐使用该方法。
3.日期/时间组件方法
剩下的 Date 类型的方法如下所示:
UTC 日期指的是在没有时区偏差的情况下(将日期转换为 GMT 时间)的日期值。
方法 | 说明 |
---|---|
getTime() | 返回表示日期的毫秒数;与 valueOf() 方法返回的值相同 |
setTime(毫秒) | 以毫秒数设置日期,会改变整个日期 |
getFullYear() | 取得4位数表示的年份 |
getUTCFullYear() | 返回 UTC 日期的4位数年份 |
setFullYear(年) | 设置日期的年份。传入的年份值必须是4位数字 |
setUTCFullYear(年) | 设置 UTC 日期的年份。传入的年份值必须是4位数字 |
getMonth() | 返回日期中的月份,其中0表示一月,11表示十二月 |
getUTCMonth() | 返回 UTC 日期中的月份,其中0表示一月,11表示十二月 |
setMonth(月) | 设置日期的月份。传入的值必须大于0,超过11则增加年份 |
setUTCMonth(月) | 设置 UTC 日期的月份。传入的月份值必须大于0,超过11则增加年份 |
getDate() | 返回日期月份中的天数(1到31) |
getUTCDate() | 返回 UTC 日期月份中的天数(1到31) |
setDate(日) | 设置日期月份中的天数。如果传入的值超过了该月中应有的天数,则增加月份 |
setUTCDate(日) | 设置UTC日期月份中的天数。如果传入的值超过了该月中应有的天数,则增加月份 |
getDay() | 返回日期中星期的星期几(其中0表示星期日,6表示星期六) |
getUTCDay() | 返回UTC日期中星期的星期几(其中0表示星期日,6表示星期六) getHours() |
getUTCHours() | 返回UTC日期中的小时数(0到23) |
setHours(时) | 设置日期中的小时数。传入的值超过了23则增加月份中的天数 setUTCHours(时) |
getMinutes() | 返回日期中的分钟数(0到59) |
getUTCMinutes() | 返回UTC日期中的分钟数(0到59) |
setMinutes(分) | 设置日期中的分钟数。传入的值超过59则增加小时数 |
setUTCMinutes(分) | 设置UTC日期中的分钟数。传入的值超过59则增加小时数 |
getSeconds() | 返回日期中的秒数(0到59) |
getUTCSeconds() | 返回UTC日期中的秒数(0到59) |
setSeconds(秒) | 设置日期中的秒数。传入的值超过了59会增加分钟数 |
setUTCSeconds(秒) | 设置UTC日期中的秒数。传入的值超过了59会增加分钟数 |
getMilliseconds() | 返回日期中的毫秒数 |
getUTCMilliseconds() | 返回 UTC 日期中的毫秒数 |
setMilliseconds(毫秒) | 设置日期中的毫秒数 |
setUTCMilliseconds(毫秒) | 设置UTC日期中的毫秒数 |
getTimezoneOffset() | 返回本地时间与 UTC 时间相差的分钟数。 |