Moment.js是一个轻量级的JavaScript时间库,它方便了日常开发中对时间的操作,提高了开发效率。
日常开发中,通常会对时间进行下面这几个操作:比如获取时间,设置时间,格式化时间,比较时间等等。接下来,我将按照这些操作对Moment.js中的Doc进行整理分类,方便学习和日后的查阅。
moment.js是一款转换时间的插件
安装方式为:
npm install moment --save
其常用的格式化参数如下表所示:
格式代码 说明 返回值例子
M 数字表示的月份,没有前导零 1到12
MM 数字表示的月份,有前导零 01到12
MMM 三个字母缩写表示的月份 Jan到Dec
MMMM 月份,完整的文本格式 January到December
Q 季度 1到4
D 月份中的第几天,没有前导零 1到31
DD 月份中的第几天,有前导零 01到31
d 星期中的第几天,数字表示 0到6,0表示周日,6表示周六
ddd 三个字母表示星期中的第几天 Sun到Sat
dddd 星期几,完整的星期文本 从Sunday到Saturday
w 年份中的第几周 如42:表示第42周
YYYY 四位数字完整表示的年份 如:2014 或 2000
YY 两位数字表示的年份 如:14 或 98
A 大写的AM PM AM PM
a 小写的am pm am pm
HH 小时,24小时制,有前导零 00到23
H 小时,24小时制,无前导零 0到23
hh 小时,12小时制,有前导零 00到12
h 小时,12小时制,无前导零 0到12
m 没有前导零的分钟数 0到59
mm 有前导零的分钟数 00到59
s 没有前导零的秒数 1到59
ss 有前导零的描述 01到59
X Unix时间戳 1411572969
常用的转换
1.时间格式化
moment().format('YYYY-MM-DD HH:mm:ss');获取当前时间 2018-09-18 12:06:09
moment().format('L') 2018-07-04
moment().format('LL') 2018年7月4日
moment().format('LLL') 2018年7月4日晚上5点55分
moment().format('LLLL') 2018年7月4日星期三晚上5点55分
moment().format('X'); 转换当前时间的Unix时间戳
moment().format('d'); 今天是周几
2.日期格式化
moment().format('dddd') 星期三
moment().format('MMM Do YY') 7月4日 18
moment().format() 2018-07-04T18:04:52+08:00
3.日历格式化
moment().subtract(1,'days').calendar();昨天下午5点55分
moment.calendar();今天下午5点55分
moment().add(1,'days').calendar();明天下午5点55分
4.时间戳转为时间
(1)时间戳秒转时间
moment(Number);
(2)时间戳毫秒转时间
var day = moment.unix(1318781876);
5.时间差转化为相对的秒、分钟或者小时
这里的stopTime和 startTime为开始和结束的日期格式,需要将时间差转化为秒或者分钟,再进行逻辑判断。
let consumingSeconds = moment.duration(moment(stopTime).valueOf()- moment(startTime).valueOf()).as('seconds');
let consumingMinutes = moment.duration(moment(stopTime).valueOf()- moment(startTime).valueOf()).as('minutes');
let consumingHours = moment.duration(moment(stopTime).valueOf()- moment(startTime).valueOf()).as('hours');
获取时间
Start of Time
moment().startOf(String)
获取今天0时0分0秒
moment().startOf('day')
获取本周第一天(周日)0时0分0秒
moment().startOf('week')
获取本周周一0时0分0秒
moment().startOf('isoWeek')
获取当前月第一天0时0分0秒
moment().startOf('month')
End of Time
moment().endOf(String)
获取今天23时59分59秒
moment().endOf('day')
获取本周最后一天(周六)23时59分59秒
moment().endOf('week')
获取本周周日23时59分59秒
moment().endOf('isoWeek')
获取当前月最后一天23时59分59秒
moment().endOf('month')
Days in Month
moment().daysInMonth()
获取当前月的总天数
moment().daysInMonth()
Timestamp
获取时间戳(以秒为单位)
moment().format('X') // 返回值为字符串类型
moment().unix() // 返回值为数值型
获取时间戳(以毫秒为单位)
moment().format('x') // 返回值为字符串类型
moment().valueOf() // 返回值为数值型
Get Time
获取年份
moment().year()
moment().get('year')
获取月份
moment().month() (0~11, 0: January, 11: December)
moment().get('month')
获取一个月中的某一天
moment().date() moment().get('date')
获取一个星期中的某一天
moment().day() (0~6, 0: Sunday, 6: Saturday)
moment().weekday() (0~6, 0: Sunday, 6: Saturday)
moment().isoWeekday() (1~7, 1: Monday, 7: Sunday)
moment().get('day')
mment().get('weekday')
moment().get('isoWeekday')
获取小时
moment().hours() moment().get('hours')
获取分钟
moment().minutes() moment().get('minutes')
获取秒数
moment().seconds() moment().get('seconds')
获取当前的年月日时分秒
moment().toArray() // [years, months, date, hours, minutes, seconds, milliseconds]
moment().toObject() // {years: xxxx, months: x, date: xx ...}
设置时间
Set Time
moment().year(Number), moment().month(Number)...
moment().set(String, Int)
moment().set(Object)
设置年份
moment().year(2019)
moment().set('year', 2019)
moment().set({year: 2019})
设置月份
moment().month(11) (0~11, 0: January, 11: December)
moment().set('month', 11)
设置某个月中的某一天
moment().date(15)
moment().set('date', 15)
设置某个星期中的某一天
moment().weekday(0) // 设置日期为本周第一天(周日)
moment().isoWeekday(1) // 设置日期为本周周一
moment().set('weekday', 0)
moment().set('isoWeekday', 1)
设置小时
moment().hours(12)
moment().set('hours', 12)
设置分钟
moment().minutes(30)
moment().set('minutes', 30)
设置秒数
moment().seconds(30)
moment().set('seconds', 30)
Add Time
moment().add(Number, String)
moment().add(Object)
设置年份
moment().add(1, 'years')
moment().add({years: 1})
设置月份
moment().add(1, 'months')
设置日期
moment().add(1, 'days')
设置星期
moment().add(1, 'weeks')
设置小时
moment().add(1, 'hours')
设置分钟
moment().add(1, 'minutes')
设置秒数
moment().add(1, 'seconds')
Subtract Time
moment().subtract(Number, String)
moment().subtract(Object)
设置年份
moment().subtract(1, 'years')
moment().subtract({years: 1})
设置月份
moment().subtract(1, 'months')
设置日期
moment().subtract(1, 'days')
设置星期
moment().subtract(1, 'weeks')
设置小时
moment().subtract(1, 'hours')
设置分钟
moment().subtract(1, 'minutes')
设置秒数
moment().subtract(1, 'seconds')
格式化时间
Format Time
moment().format()
moment().format(String)
格式化年月日: 'xxxx年xx月xx日'
moment().format('YYYY年MM月DD日')
格式化年月日: 'xxxx-xx-xx'
moment().format('YYYY-MM-DD')
格式化时分秒(24小时制): 'xx时xx分xx秒'
moment().format('HH时mm分ss秒')
格式化时分秒(12小时制):'xx:xx:xx am/pm'
moment().format('hh:mm:ss a')
格式化时间戳(以秒为单位)
moment().format('X') // 返回值为字符串类型
格式化时间戳(以毫秒为单位)
moment().format('x') // 返回值为字符串类型
比较时间
Difference
moment().diff(Moment|String|Number|Date|Array)
获取两个日期之间的时间差
let start_date = moment().subtract(1, 'weeks')
let end_date = moment()
end_date.diff(start_date) // 返回毫秒数
end_date.diff(start_date, 'months') // 0
end_date.diff(start_date, 'weeks') // 1
end_date.diff(start_date, 'days') // 7
start_date.diff(end_date, 'days') // -7
转化为JavaScript原生Date对象
moment().toDate()
new Date(moment())
将Moment时间转换为JavaScript原生Date对象
let m = moment()
let nativeDate1 = m.toDate()
let nativeDate2 = new Date(m)
String(nativeDate1) === String(nativeDate2) // true