JavaScript标准库

JavaScript标准库

Date对象是 JavaScript 原生的时间库。它以国际标准时间（UTC）1970年1月1日00:00:00作为时间的零点，可以表示的时间范围是前后各1亿天（单位为毫秒）。

- 普通函数的用法Date();// 'Mon Apr 05 2021 15:57:31 GMT+0800 (中国标准时间)'Date(2020,1,2);//  'Mon Apr 05 2021 15:57:31 GMT+0800 (中国标准时间)'// 不管有没有参数，直接调用Date总是返回当前时间- 构造函数的用法let today = new Date(); // 2021-04-05T07:59:25.704Z// Date实例有一个独特的地方。其他对象求值的时候，都是默认调用.valueOf()方法，但是Date实例求值的时候，默认调用的是toString()方法。这导致对Date实例求值，返回的是一个字符串，代表该实例对应的时间。// 参数为时间零点开始计算的毫秒数new Date(1378218728000)// Tue Sep 03 2013 22:32:08 GMT+0800 (CST)// 参数为日期字符串new Date('January 6, 2013');// Sun Jan 06 2013 00:00:00 GMT+0800 (CST)// 参数为多个整数，// 代表年、月、日、小时、分钟、秒、毫秒new Date(2013, 0, 1, 0, 0, 0, 0)// Tue Jan 01 2013 00:00:00 GMT+0800 (CST)/** 1.参数是负整数时，代表1970年元旦之前的时间* 2.只要是能被Date.parse()方法解析的字符串，都可以当作参数* 3. 参数为年、月、日等多个整数时，年和月是不能省略的，其他参数都可以省略的,省略的话会将这个参数解释为毫秒数*//*各个参数的取值范围如下。年：使用四位数年份，比如2000。如果写成两位数或个位数，则加上1900，即10代表1910年。如果是负数，表示公元前。月：0表示一月，依次类推，11表示12月。日：1到31。小时：0到23。分钟：0到59。秒：0到59毫秒：0到999。*/new Date(2013, 0, 0);// 2012-12-30T16:00:00.000Z 日期为0代表上个月的最后一天new Date(2013, 15);// 2014-03-31T16:00:00.000Z

日期的运算

- 两个日期实例对象进行减法运算时，返回的是它们间隔的毫秒数；进行加法运算时，返回的是两个字符串连接而成的新字符串(因为两个日期实例对象进行减法运算时，返回的是它们间隔的毫秒数；进行加法运算时，返回的是两个字符串连接而成的新字符串)let D1 = new Date(2021,3,1);let D2 = new Date(2021,4,1);D2 - D1; // 2592000000D1 - D2; //-2592000000D1 + D2; // 'Thu Apr 01 2021 00:00:00 GMT+0800 (中国标准时间)Sat May 01 2021 00:00:00 GMT+0800 (中国标准时间)'

静态方法

- w(): 返回当时时间距离时间零点的毫秒数。(时间零点:1970年1月1日 00:00:00 w();// 1617611434958- Date.parse():用来解析日期字符串，返回该时间距离 时间零点 的毫秒数。Date.parse('Apr 5, 2021'); // 1617552000000Date.parse('2021-4-5'); //1617552000000Date.parse('2021-04-05'); // 1617580800000Date.parse('Apr 5, 2021 16:33:45');// 1617611625000Date.parse('xxx');// NaN 如果解析失败返回NaN- Date.UTC() :接受年、月、日等变量作为参数，返回该时间距离 时间零点 的毫秒数。// 格式Date.UTC(year, month[, date[, hrs[, min[, sec[, ms]]]]])Date.UTC(2021,4,5,16,38,50); //1620232730000   

实例方法

Date的实例对象，有几十个自己的方法，除了valueOf和toString，可以分为以下三类。

• to类：从Date对象返回一个字符串，表示指定的时间。
• get类：获取Date对象的日期和时间。
• set类：设置Date对象的日期和时间。

Date.prototype.valueOf()

- valueOf方法返回实例对象距离 时间零点 对应的毫秒数，该方法等同于getTime方法let D1 = new Date();D1; // 2021-04-05T08:45:42.317ZD1.valueOf(); //Time(); //1617612342319

to类方法

Sring():返回一个完整日期字符串

let D1 = new Date();
D1.toString(); //'Mon Apr 05 2021 16:57:23 GMT+0800 (中国标准时间)'

UTCString():返回对应的 UTC 时间，也就是比北京时间晚8个小时

let D1 = new Date();
D1.toString();//'Mon Apr 05 2021 16:58:27 GMT+0800 (中国标准时间)'
D1.toUTCString()//'Mon, 05 Apr 2021 08:58:27 GMT'

ISOString():返回对应时间的ISO8601写法

let D1 = new Date();
D1.toISOString();  //'2021-04-05T09:35:17.144Z'
// toISOString()方法返回的总是UTC时区的时间

JSON():返回一个符合 JSON 格式的 ISO 日期字符串，与toISOString方法的返回结果完全相同

let D1 = new Date();
D1.toISOString(); //'2021-04-05T09:36:49.986Z'
D1.toJSON(); //'2021-04-05T09:36:49.986Z'

DateString():返回日期字符串（不含小时、分和秒）

let D1 = new Date();
D1.toDateString();  //'Mon Apr 05 2021'

TimeString():返回时间字符串（不含年月日）

let D1 = new Date();
D1.toTimeString();  // '17:38:51 GMT+0800 (中国标准时间)'

本地时间

- LocaleString()：完整的本地时间LocaleDateString()：本地日期（不含小时、分和秒）LocaleTimeString()：本地时间（不含年月日）let D1 = new Date();D1.toLocaleString(); //'2021/4/5 下午9:48:46&#LocaleDateString();//'2021/4/5&#LocaleTimeString();//'下午9:48:46'- 这三个方法都有两个可选的参数* 第一个参数 locales指定所用语言的字符串* 第二个参数 options是一个配置对象let D1 = new Date();D1.toLocaleString('en-US'); //'4/5/2021, 9:52:19 PM' 指定语言为英文D1.toLocaleString('zh-CN');  //'2021/4/5 下午9:52:19' 指定语言为中文-- options配置对象有以下属性。dateStyle：可能的值为full、long、medium、short。timeStyle：可能的值为full、long、medium、short。month：可能的值为numeric、2-digit、long、short、narrow。year：可能的值为numeric、2-digit。weekday：可能的值为long、short、narrow。day、hour、minute、second：可能的值为numeric、2-digit。timeZone：可能的值为 IANA 的时区数据库。timeZooneName：可能的值为long、short。hour12：24小时周期还是12小时周期，可能的值为true、false。let D1 = new Date(2013, 0, 1);D1.toLocaleDateString('en-US', {weekday: 'long',year: 'numeric',month: 'long',day: 'numeric'}) //'Tuesday, January 1, 2013'

get类方法

• getTime()：返回实例距离1970年1月1日00:00:00的毫秒数，等同于valueOf方法。
• getDate()：返回实例对象对应每个月的几号（从1开始）。
• getDay()：返回星期几，星期日为0，星期一为1，以此类推。
• getFullYear()：返回四位的年份。
• getMonth()：返回月份（0表示1月，11表示12月）。
• getHours()：返回小时（0-23）。
• getMilliseconds()：返回毫秒（0-999）。
• getMinutes()：返回分钟（0-59）。
• getSeconds()：返回秒（0-59）。
• getTimezoneOffset()：返回当前时间与 UTC 的时区差异，以分钟表示，返回结果考虑到了夏令时因素。

let D1 = new Date();
D1.toLocaleString(); //'2021/4/5 下午10:00:15'
D1.getTime(); //1617631215844
D1.getDate(); //5 几号
D1.getDay(); // 1 周几
D1.getFullYear();//2021
D1.getTimezoneOffset();//-480//所有这些`get*`方法返回的都是整数，不同方法返回值的范围不一样。/* 分钟和秒：0 到 59小时：0 到 23星期：0（星期天）到 6（星期六）日期：1 到 31月份：0（一月）到 11（十二月）*/

计算本年度还剩多少天

function leftDays() {var today = new Date();var endYear = new FullYear(), 11, 31, 23, 59, 59, 999);var msPerDay = 24 * 60 * 60 * 1000;und((Time() - Time()) / msPerDay);
}

Date对象还提供了这些方法对应的 UTC 版本，用来返回 UTC 时间。

• getUTCDate()
• getUTCFullYear()
• getUTCMonth()
• getUTCDay()
• getUTCHours()
• getUTCMinutes()
• getUTCSeconds()
• getUTCMilliseconds()

set类方法

Date对象提供了一系列set*方法，用来设置实例对象的各个方面。

• setDate(date)：设置实例对象对应的每个月的几号（1-31），返回改变后毫秒时间戳。
• setFullYear(year [, month, date])：设置四位年份。
• setHours(hour [, min, sec, ms])：设置小时（0-23）。
• setMilliseconds()：设置毫秒（0-999）。
• setMinutes(min [, sec, ms])：设置分钟（0-59）。
• setMonth(month [, date])：设置月份（0-11）。
• setSeconds(sec [, ms])：设置秒（0-59）。
• setTime(milliseconds)：设置毫秒时间戳。

// set*方法的参数都会自动折算。以setDate()为例，如果参数超过当月的最大天数，则向下一个月顺延，如果参数是负数，表示从上个月的最后一天开始减去的天数。// set类方法和get类方法，可以结合使用，得到相对时间。let D1 = new Date();// 将日期向后推1000天D1.Date() + 1000);// 将时间设为6小时后D1.Hours() + 6);// 将年份设为去年D1.FullYear() - 1);

set*系列方法除了setTime()，都有对应的 UTC 版本，即设置 UTC 时区的时间。

• setUTCDate()
• setUTCFullYear()
• setUTCHours()
• setUTCMilliseconds()
• setUTCMinutes()
• setUTCMonth()
• setUTCSeconds()