一、介绍及安装
1.1 介绍
Moment.js是一个优秀的JavaScript 日期处理类库.
如果没有Moment.js之类的日期处理库,我们如果需要获得格式化后的日期.往往需要通过new Date().getMonth()
...之类方法进行拼接, 或者使用JQ封装的函数. 但现在但SPA页面不怎么使用JQ.所以掌握靠谱的Moment.js
还是很有必要的
举个小小例子:
请听题: 通过原生js和moment.js分别获取
moment().format('YYYY-MM-DD HH:mm:ss')
格式的时间
const js_date = new Date();
const moment_date = moment();
console.log('js new Date() ==========>', `${js_date.getFullYear()}-${js_date.getMonth() + 1}-${js_date.getDate()} ${js_date.getHours()}:${js_date.getMinutes()}:${js_date.getSeconds()}`)
console.log('moment moment() ==========>', moment_date.format('YYYY-MM-DD HH:mm:ss'))
输出结果:
js new Date() ==========> 2018-11-1 18:0:59
moment moment() ==========> 2018-11-01 18:00:59
momentjs
优势之处显而易见
1.2 安装
环境 | 安装方式 | 引入例子 | 描述 |
---|---|---|---|
Node.js | npm install moment -D | 1⃣️ | 通常用在react 、vue 等单页面项目 |
浏览器 | 可官网单独下载js,也可以通过npm install moment ,然后引入里面的js |
2⃣️️ | 一般直接在html文件里使用 |
1⃣️ Node.js(React、Vue):
//导入
import moment from 'moment' //ES6
const moment = require('moment') //AMD规范
//使用
let nowTime = moment() //当前时间
...
2⃣️ 浏览器(.html): 本文的案例均采用这种方式
//导入
//js文件既可以自己去官网首页下载,也可以通过npm install moment获得
const moment = moment(); //当前时间
二、API大全
2.1 解析时间格式
解析时间格式意思就是当传入某个时间字符串的时候, moment.js
可以解析出YYYY-MM-DD
之类的格式
语法:
moment(时间内容-String)
例子:
var analysisMoment = moment("1995-12-25");
console.log(analysisMoment)
输出的部分结果:
_d: Mon Dec 25 1995 00:00:00 GMT+0800 (CST) {}
_f: "YYYY-MM-DD"
_i: "1995-12-25"
_isAMomentObject: true
_isUTC: false
_isValid: true
甚至还可以解析出[1995, 12, 25]
2.2 转换时间格式
这个功能是我们经常会用到的.也是文章最开始举例使用的方法.
语法:
moment(内容-String).format(格式-String)
const dateString = '2018-11-01'
const transformFormat = moment(dateString).format('YYYY MM DD')
console.log('transformFormat =========>', transformFormat)
只要Y、M、D、H、m、s...写对了,无论转换成什么格式都可以!
momemt('20181101').format('YY年MM月DD日')
//输出 18年11月01日
2.3 创建/调整日期
创建日期例子:
moment({ y: 2018, Month: 11, day: 01, hour:15, minute:10 });
修改日期:
语法:
moment().seconds() === new Date().getSeconds();
同理还有:
毫秒:millsecond(Number)
分钟:minute(Number)
星期:day(Number|String
年: year(Number)
...
例子:
console.log('修改月份为二月 =========>', moment().month('Feb').format('YYYY MM DD') )
console.log('修改当前时间的小时为九点:下班 =========>', moment().seconds(30).format('YYYY MM DD HH:mm'))
输出结果:
修改当前时间的月份为二月 =========> 2018 02 01
修改当前时间的小时为九点:下班 =========> 2018 11 01 20:05
2.3 日期操作方法
增加/减少日期
语法:
moment().add(Number, String);
moment().add(Duration);
moment().add(Object);
例子: 在当前时间增加/减少7天
//方式一 (Number, String)
console.log('当前时间增加7天:', moment().add(7, 'd').format('YYYY MM DD'))
console.log('当前时间减少两个月', moment().subtract(2, 'months').format('YYYY-MM-DD'))
//方式二、三 (二可结合moment.duration())
console.log('当前时间增加2天', moment().add({'day': 2}).format('YYYY-MM-DD'))
/***输出***/
//方式一
当前时间增加7天: 2018-11-08
当前时间减少两个月 2018-09-01
//方式二
当前时间增加2天 2018-11-03
2.4 日期相关显示
时间差显示
和当前时间比较
语法:
//以当前时间为基准进行对比
moment().fromNow(Boolean); //之前
moment().toNow(); //之后
//布尔值可省略,如加上则只显示时间差
例子:
console.log('2008年和今天:', moment([2008, 11, 1]).fromNow())
console.log('2008年和今天相差:', moment([2008, 11, 1]).fromNow(true))
//输出
2008年和今天: 10 years ago
2008年和今天相差: 10 years
和之前/之后时间比较
语法:
moment().from(Moment|String|Number|Date|Array, Boolean); //之前
moment().to(Moment|String|Number|Date|Array, Boolean); //之后
例子:
//from
var a = moment([2007, 0, 28]);
var b = moment([2007, 0, 29]);
a.from(b); // "a day ago"
a.from([2007, 0, 29]); // "a day ago"
a.from(new Date(2007, 0, 29)); // "a day ago"
a.from("2007-01-29"); // "a day ago"
其他
简写(key <=> Shorthand)对比表可以参考:
《Momentjs docs》《Moment.js官网》