前端常用时间工具 -- Moment.js常见用法总结

Moment.js常见用法总结

Moment.js常见用法总结

Moment.js是一个轻量级的JavaScript时间库，它方便了日常开发中对时间的操作，提高了开发效率。
​日常开发中，通常会对时间进行下面这几个操作：比如获取时间，设置时间，格式化时间，比较时间等等。接下来，我将按照这些操作对Moment.js中的Doc进行整理分类，方便学习和日后的查阅。

获取时间

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秒
获取本周周日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