日期(Date) – 君土

创建一个 JavaScript Date 实例，该实例呈现时间中的某个时刻。Date 对象则基于 Unix Time Stamp，即自1970年1月1日（UTC）起经过的毫秒数。

const date1 = new 日期('December 17, 1995 03:24:00');
// Sun Dec 17 1995 03:24:00 GMT...

const date2 = new 日期('1995-12-17T03:24:00');
// Sun Dec 17 1995 03:24:00 GMT...

console.log(date1 === date2);
// expected output: false;

console.log(date1 - date2);
// expected output: 0

语法

new 日期();
new 日期(值);
new 日期(日期文);
new 日期(year, monthIndex [, day [, hours [, minutes [, seconds [, milliseconds]]]]]);

创建一个新Date对象的唯一方法是通过new 操作符，例如：let now = new Date();
若将它作为常规函数调用（即不加 new 操作符），将返回一个字符串，而非 Date 对象。

参数

日期() 构造函数有四种基本形式

没有参数

如果没有提供参数，那么新创建的日期(Date)对象表示实例化时刻的日期和时间。

Unix时间戳

值(value)
一个 Unix 时间戳（Unix Time Stamp），它是一个整数值，表示自1970年1月1日00:00:00 UTC（the Unix epoch）以来的毫秒数，忽略了闰秒。请注意大多数 Unix 时间戳功能仅精确到最接近的秒。

时间戳字符串

日期文(dateString)
表示日期的字符串值。该字符串应该能被 Date.parse() 正确方法识别（即符合 IETF-compliant RFC 2822 timestamps 或 version of ISO8601）。

注意: 由于浏览器之间的差异与不一致性，强烈不推荐使用Date构造函数来解析日期字符串 (或使用与其等价的Date.parse)。对 RFC 2822 格式的日期仅有约定俗称的支持。对 ISO 8601 格式的支持中，仅有日期的串 (例如 “1970-01-01”) 会被处理为 UTC 而不是本地时间，与其他格式的串的处理不同。

分别提供日期与时间的每一个成员

当至少提供了年份与月份时，这一形式的 Date() 返回的 Date 对象中的每一个成员都来自下列参数。没有提供的成员将使用最小可能值（对日期为1，其他为0）。

year
表示年份的整数值。 0到99会被映射至1900年至1999年，其它值代表实际年份。参见示例。

monthIndex
表示月份的整数值，从 0（1月）到 11（12月）。

day
可选表示一个月中的第几天的整数值，从1开始。默认值为1。

hours
可选表示一天中的小时数的整数值 (24小时制)。默认值为0（午夜）。

minutes
可选表示一个完整时间（如 01:10:00）中的分钟部分的整数值。默认值为0。

seconds
可选表示一个完整时间（如 01:10:00）中的秒部分的整数值。默认值为0。

milliseconds
可选表示一个完整时间的毫秒部分的整数值。默认值为0。

使用注释

注意参数monthIndex 是从“0”开始计算的，这就意味着一月份为“0”，十二月份为“11”。

注意：当Date作为构造函数调用并传入多个参数时，如果数值大于合理范围时（如月份为 13 或者分钟数为 70），相邻的数值会被调整。比如 new Date(2013, 13, 1)等于new Date(2014, 1, 1)，它们都表示日期2014-02-01（注意月份是从0开始的）。其他数值也是类似，new Date(2013, 2, 1, 0, 70)等于new Date(2013, 2, 1, 1, 10)，都表示同一个时间：2013-03-01T01:10:00。

注意：当Date作为构造函数调用并传入多个参数时，所定义参数代表的是当地时间。如果需要使用世界协调时 UTC，使用 new Date(Date.UTC(...)) 和相同参数。

简介

如果没有输入任何参数，则Date的构造器会依据系统设置的当前时间来创建一个Date对象。
如果提供了至少两个参数，其余的参数均会默认设置为 1（如果没有指定 day 参数）或者 0（如果没有指定 day 以外的参数）。
JavaScript的时间由世界标准时间（UTC）1970年1月1日开始，用毫秒计时，一天由 86,400,000 毫秒组成。Date 对象的范围是 -100,000,000 天至 100,000,000 天（等效的毫秒值）。
Date 对象为跨平台提供了统一的行为。时间属性可以在不同的系统中表示相同的时刻，而如果使用了本地时间对象，则反映当地的时间。
Date 对象支持多个处理 UTC 时间的方法，也相应地提供了应对当地时间的方法。UTC，也就是我们所说的格林威治时间，指的是time中的世界时间标准。而当地时间则是指执行JavaScript的客户端电脑所设置的时间。
以一个函数的形式来调用 Date 对象（即不使用 new 操作符）会返回一个代表当前日期和时间的字符串。

属性

Date.prototype
允许为 Date 对象添加属性。

Date.length
Date.length 的值是 7。这是该构造函数可接受的参数个数。

方法

日期.现在() – Date.now()
返回自 1970-1-1 00:00:00 UTC（世界标准时间）至今所经过的毫秒数。

日期.析() – Date.parse()
解析一个表示日期的字符串，并返回从 1970-1-1 00:00:00 所经过的毫秒数。

注意: 由于浏览器差异和不一致，强烈建议不要使用 日期.析(Date.parse) 解析字符串。

日期.标准时() – Date.UTC()
接受和构造函数最长形式的参数相同的参数（从2到7），并返回从 1970-01-01 00:00:00 UTC 开始所经过的毫秒数。

JavaScript `Date` 实例

所有的 Date 实例都继承自 Date.prototype。修改 Date 构造函数的原型对象会影响到所有的 Date 实例。

实例属性

Date.prototype.constructor
返回创建了实例的构造函数，默认是 Date 构造函数。

实例方法

Getter

取日期() – Date.prototype.getDate()
根据本地时间返回指定日期对象的月份中的第几天（1-31）。

取天() – Date.prototype.getDay()
根据本地时间返回指定日期对象的星期中的第几天（0-6）。

取年() – Date.prototype.getFullYear()
根据本地时间返回指定日期对象的年份（四位数年份时返回四位数字）。

取时() – Date.prototype.getHours()
根据本地时间返回指定日期对象的小时（0-23）。

取毫秒() – Date.prototype.getMilliseconds()
根据本地时间返回指定日期对象的毫秒（0-999）。

取分() – Date.prototype.getMinutes()
根据本地时间返回指定日期对象的分钟（0-59）。

月() – Date.prototype.getMonth()
根据本地时间返回指定日期对象的月份（0-11）。

秒() – Date.prototype.getSeconds()
根据本地时间返回指定日期对象的秒数（0-59）。

取时间() – Date.prototype.getTime()
返回从1970-1-1 00:00:00 UTC（协调世界时）到该日期经过的毫秒数，对于1970-1-1 00:00:00 UTC之前的时间返回负值。

取时区偏移() – Date.prototype.getTimezoneOffset()
返回当前时区的时区偏移。

取标准日期() – Date.prototype.getUTCDate()
根据世界时返回特定日期对象一个月的第几天（1-31）.

取标准天() – Date.prototype.getUTCDay()
根据世界时返回特定日期对象一个星期的第几天（0-6）.

取标准年() – Date.prototype.getUTCFullYear()
根据世界时返回特定日期对象所在的年份（4位数）.

取标准时() – Date.prototype.getUTCHours()
根据世界时返回特定日期对象当前的小时（0-23）.

取标准毫秒() – Date.prototype.getUTCMilliseconds()
根据世界时返回特定日期对象的毫秒数（0-999）.

取标准分() – Date.prototype.getUTCMinutes()
根据世界时返回特定日期对象的分钟数（0-59）.

取标准月() – Date.prototype.getUTCMonth()
根据世界时返回特定日期对象的月份（0-11）.

取标准秒() – Date.prototype.getUTCSeconds()
根据世界时返回特定日期对象的秒数（0-59）.

短年() – Date.prototype.getYear()
根据特定日期返回年份 (通常 2-3 位数). 使用 getFullYear() .

Setter

置日期() – Date.prototype.setDate()
根据本地时间为指定的日期对象设置月份中的第几天。

置年() – Date.prototype.setFullYear()
根据本地时间为指定日期对象设置完整年份（四位数年份是四个数字）。

置时() – Date.prototype.setHours()
根据本地时间为指定日期对象设置小时数。

置毫秒() – Date.prototype.setMilliseconds()
根据本地时间为指定日期对象设置毫秒数。

置分() – Date.prototype.setMinutes()
根据本地时间为指定日期对象设置分钟数。

置月() – Date.prototype.setMonth()
根据本地时间为指定日期对象设置月份。

置秒() – Date.prototype.setSeconds()
根据本地时间为指定日期对象设置秒数。

置时间() – Date.prototype.setTime()
通过指定从 1970-1-1 00:00:00 UTC 开始经过的毫秒数来设置日期对象的时间，对于早于 1970-1-1 00:00:00 UTC的时间可使用负值。

置标准日() – Date.prototype.setUTCDate()
根据世界时设置 Date 对象中月份的一天 (1 ~ 31)。

置标准年() – Date.prototype.setUTCFullYear()
根据世界时设置 Date 对象中的年份（四位数字）。

置标准时() – Date.prototype.setUTCHours()
根据世界时设置 Date 对象中的小时 (0 ~ 23)。

置标准毫秒() – Date.prototype.setUTCMilliseconds()
根据世界时设置 Date 对象中的毫秒 (0 ~ 999)。

置标准分() – Date.prototype.setUTCMinutes()
根据世界时设置 Date 对象中的分钟 (0 ~ 59)。

置标准月() – Date.prototype.setUTCMonth()
根据世界时设置 Date 对象中的月份 (0 ~ 11)。

置标准秒() – Date.prototype.setUTCSeconds()
根据世界时设置 Date 对象中的秒钟 (0 ~ 59)。

置短年() – Date.prototype.setYear()
setYear() 方法用于设置年份。请使用 setFullYear() 方法代替。

Conversion getter

转日期字串() – Date.prototype.toDateString()
以人类易读（human-readable）的形式返回该日期对象日期部分的字符串。

转国际字串() – Date.prototype.toISOString()
把一个日期转换为符合 ISO 8601 扩展格式的字符串。

转像谱() – Date.prototype.toJSON()
使用 toISOString() 返回一个表示该日期的字符串。为了在 JSON.stringify() 方法中使用。

Date.prototype.toGMTString()
返回一个基于 GMT (UT) 时区的字符串来表示该日期。请使用 toUTCString() 方法代替。

转本地日期字串() – Date.prototype.toLocaleDateString()
返回一个表示该日期对象日期部分的字符串，该字符串格式与系统设置的地区关联（locality sensitive）。

转本地字串() – Date.prototype.toLocaleFormat()
使用格式字符串将日期转换为字符串。

转本地字串() – Date.prototype.toLocaleString()
返回一个表示该日期对象的字符串，该字符串与系统设置的地区关联（locality sensitive）。覆盖了 Object.prototype.toLocaleString() 方法。

转本地时间字串() – Date.prototype.toLocaleTimeString()
返回一个表示该日期对象时间部分的字符串，该字符串格式与系统设置的地区关联（locality sensitive）。

Date.prototype.toSource()
返回一个与Date等价的原始字符串对象，你可以使用这个值去生成一个新的对象。重写了 Object.prototype.toSource() 这个方法。

转字串() – Date.prototype.toString()
返回一个表示该日期对象的字符串。覆盖了Object.prototype.toString() 方法。

转时间字串() – Date.prototype.toTimeString()
以人类易读格式返回日期对象时间部分的字符串。

转标准字串() – Date.prototype.toUTCString()
把一个日期对象转换为一个以UTC时区计时的字符串。

原值() – Date.prototype.valueOf()
返回一个日期对象的原始值。覆盖了 Object.prototype.valueOf() 方法。

例子

>例子：创建一个日期对象的几种方法

下例展示了用来创建一个日期对象的多种方法。

注意: 由于浏览器差异和不一致性，强烈建议不要使用Date构造函数（和Date.parse，它们是等效的）解析日期字符串。

var today = new Date();
var birthday = new Date('December 17, 1995 03:24:00');
var birthday = new Date('1995-12-17T03:24:00');
var birthday = new Date(1995, 11, 17);
var birthday = new Date(1995, 11, 17, 3, 24, 0);

例子：将两位数年份映射为 1900 – 1999 年

为了创建和获取 0 到 99 之间的年份，应使用 Date.prototype.setFullYear() 和 Date.prototype.getFullYear() 方法。

var date = new Date(98, 1); // Sun Feb 01 1998 00:00:00 GMT+0000 (GMT)

// 已弃用的方法, 同样将 98 映射为 1998
date.setYear(98);           // Sun Feb 01 1998 00:00:00 GMT+0000 (GMT)

date.setFullYear(98);       // Sat Feb 01 0098 00:00:00 GMT+0000 (BST)

例子：计算经过的时间

下例展示了如何以毫秒精度计算两个日期对象的时间差：

由于不同日期、月份、年份长度的不同（日期长度不同来自夏令时的切换），使用大于秒、分钟、小时的单位表示经过的时间会遇到很多问题，在使用前需要经过详尽的调研。

// 使用 Date 对象
var start = Date.now();

// 调用一个消耗一定时间的方法：
doSomethingForALongTime();
var end = Date.now();
var elapsed = end - start; // 以毫秒计的运行时长

// 使用内建的创建方法
var start = new Date();

// 调用一个消耗一定时间的方法：
doSomethingForALongTime();
var end = new Date();
var elapsed = end.getTime() - start.getTime(); // 运行时间的毫秒值

// to test a function and get back its return
function printElapsedTime (fTest) {
    var nStartTime = Date.now(),
        vReturn = fTest(),
        nEndTime = Date.now();
    alert("Elapsed time: " + String(nEndTime - nStartTime) + " milliseconds"); 
    return vReturn;
}
yourFunctionReturn = printElapsedTime(yourFunction);

注意：在支持 Web Performance API 的高精细度（high-resolution）时间功能的浏览器中，Performance.now() 提供的所经过的时间比 Date.now() 更加可靠、精确。

获取自 Unix 起始时间以来经过的秒数

var seconds = Math.floor(Date.now() / 1000);

注意此处需要返回一个整数（仅做除法得到的不是整数），并且需要返回实际已经经过的秒数（所以这里使用了Math.floor()而不是Math.round()).

君土参考手册

语法

参数