JavaScript Dates

Date 对象是用来与年月日时分秒毫秒打交道的。

创建 Date 对象

有4种初始化日期对象的方式：

new Date()，以current date and time创建一个新的日期对象，输出为本地时间，取决于系统设定。

new Date(milliseconds)，按照 zero time（01 January 1970 00:00:00 UTC）加上参数值，创建新的日期对象。

new Date(dateString)，按指定的日期字符串创建一个新的日期对象，dateString 格式参考下面讲的 Date formats

new Date(year, month, date, hours, minutes, seconds, milliseconds)，至少指定 year 和 month。其他参数缺省时 date 置 1，剩下都置 0。

Date formats

JS有4种日期格式：

1.ISO Dates，基于 ISO 8601 国际标准，格式为 YYYY-MM-DDTHH:mm:ss.sssZ，或 YYYY-MM-DDTHH:mm:ss.sss+HH:mm，YYYY-MM-DDTHH:mm:ss.sss-HH:mm

date-only forms：

• YYYY
• YYYY-MM
• YYYY-MM-DD

“date-time” forms：（以上仅含日期字符串立即跟随）

• THH:mm
• THH:mm:ss
• THH:mm:ss.sss

ES5 规定date string不指定时区时：仅日期格式字符串，将应用 UTC 时区翻译为 utc 时间；日期时间格式字符串，以系统本地时区设置时间。

原文：When the UTC offset representation is absent, date-only forms are interpreted as a UTC time and date-time forms are interpreted as a local time.

UTC时间的2018-1-10的0时，相当于北京时区同一时间加8小时；第二个就是北京时间。

new Date('2018-01-10') // Wed Jan 10 2018 08:00:00 GMT+0800 (中国标准时间)
new Date('2018-01-10T00:00:00') // Wed Jan 10 2018 00:00:00 GMT+0800 (中国标准时间)

注意：浏览器差异性！！！ Chrome、Firefox、Edge表现一致：

Date.parse("2019-01-01T00:00:00")
Date.parse("2019-01-01T00:00:00.000")
new Date(2019, 0, 1).getTime()
// 1546272000000 北京时间，比下面的时间，少8小时

Date.parse("2019-01-01")
Date.parse("2019-01-01T00:00:00.000Z")
Date.parse("2019-01-01T00:00:00.000+00:00")
// 1546300800000 UTC时间

Safari 没有按规范来：

Date.parse("2019-01-01T00:00:00")
Date.parse("2019-01-01T00:00:00.000Z")
// 1546300800000

日期和时间字符串中间的 T 表示 UTC time.

Note: UTC (Universal Time Coordinated) is the same as GMT (Greenwich Mean Time).

修改相对UTC的时时间，需要在 dateString +HH:MM 或 -HH:MM

var d = new Date("2015-03-25T12:00:00-06:30"); // Thu Mar 26 2015 02:30:00 GMT+0800 (中国标准时间)

括号里的时间为当地时间 2015-03-25中午12点，输出时先转为 UTC 时间，加上（负数表示落后UTC）6个半小时，再加上我的本地的时区。

2.Long Dates，通常写为 “MMM DD YYYY” 或者 “DD MMM YYYY”，月份可以是完整的英文单词，也可以是缩写。（January 和 Jan 都可以）。

• 月份的英文字母大小写不敏感
• commas are ignored，年月日之间可以加逗号分隔

3.Short Dates，通常写为 “MM/DD/YYYY” 或者 “YYYY/MM/DD”，记住一点，月份 MM 必须写在 DD 几号前面

4.Full Format

JS会忽略掉 day name（星期几）和 time 括号里面的错误，随便写，帮你更正。

var d = new Date("Wed Mar 25 2015 09:56:24 GMT+0100 (W. Europe Standard Time)");

时区

设定日期时，如果不指定 time zone，JS会使用浏览器的时区。同理，获取日期时，如果不指定时区，结果会被转换成浏览器的时区。

dateObj.getTimezoneOffset()

以 minutes 返回当前系统距离 UTC 的时区差值（UTC - 当前系统），结果为正值说明落后 UTC 时间；反之超前。

var x = new Date();
var currentTimeZoneOffsetInHours = x.getTimezoneOffset() / 60; // 北京时间为 -8

显示日期

无论以何种日期格式输入，默认输出格式都是 full text string 格式：Sun May 04 2014 08:00:00 GMT+0800 (CST)

Date objects are static, not dynamic. The computer time is ticking, but date objects, once created, are not. 日期对象是静态的，一旦创建，就是一个常量，不会自己更新。

• toString()，把日期对象以美式英语形式输出，格式为当前time zone的字符串。(Tue Oct 18 2016 19:46:01 GMT+0800 (中国标准时间))
• toTimeString()，把日期对象的时间部分转为字符串（19:46:01 GMT+0800 (中国标准时间)）
• toLocaleString()，使用本地转换法，把日期对象转为字符串（2016/10/18 下午7:46:01）

• toLocaleTimeString()，使用本地转换法，把日期对象的时间部分转为字符串（下午7:46:01）

  new Date().toLocaleTimeString(‘en-US’); // “5:42:58 PM”

• toLocaleDateString()，使用本地转换法，把日期对象的日期部分转为字符串（2016/10/18）
• toISOString()，使用 ISO format 将日期对象转为字符串。格式为（YYYY-MM-DDTHH:mm:ss.sssZ），其时区总是 zero UTC offset，即 UTC 时间（末尾的”Z”表示UTC时间）
• toJSON()，将日期对象转为 JSON 日期格式的字符串（2016-10-18T11:46:01.970Z），格式同 toISOString()（ISO-8601 standard）.
• toUTCString()，toGMLString()，根据世界时间将日期对象转为字符串（Tue, 18 Oct 2016 11:46:01 GMT）
• toDateString()，把日期对象的日期部分转为字符串 (结果为 Tue Oct 18 2016)

Get Date

获取日期的常用方法：

In JavaScript, the first (0) of the week means “Sunday”，JS中的星期是从星期天开始。

getDay() 方法获得的是表示星期的数字，如果希望显示名称，可以这样做：

var d = new Date();
var days = ["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"];
document.getElementById("demo").innerHTML = days[d.getDay()];

JS中表示 month 的数字也是从 0 开始的，January 一月对应数字是 0，December 十二月是 11。

Set Date

通常拿到一个日期对象，改变这个日期的一部分。

setDate(n) can also be used to add days to a date object. If adding days, shifts the month or year, the changes are handled automatically by the Date object. 计算距离指定日期多少天以后是几月几号星期几，JS会自动帮你跨月份甚至跨年份。

Parsing Date

如果你有一个有效格式的日期字符串，使用 Date.parse(dateString) 方法可以得到距离 zero time 的毫秒数，然后使用 new Date(milliseconds) 就可以得到想要的日期对象了。

直到目前，仍然 strongly discouraged，不建议使用该方法解析日期字符串，due to browser differences and inconsistencies

Compare Dates

JS两个日期对象可以直接进行比较大小。

function validDate (date) { // 判断输入的日期是否晚于今天
  var today = new Date(), tmp = new Date(date)
  return tmp > today
}

但是不能使用 == 操作符判断日期是否相等，因为 JS Object 的比较要检查 reference，不同日期对象的 reference 一定不相等。

解决办法：

tmp <= today && tmp >= today      // 方法一：取相交的闭区间
tmp.getTime() === today.getTime() // 方法二：转成距离0时的毫秒数

Tips

1. 以当前用户系统时区的时间字符串转为 ISO 格式的字符串

new Date(dateString).toISOString()