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秒
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
实战
-
获取昨日0时0分0秒到昨日23时59分59秒, 格式:[milliseconds, milliseconds]
-
获取上周一到上周日时间范围,格式: [seconds, seconds]
-
获取上个月第一天和最后一天时间范围, 格式:[YYYY-MM-DD, YYYY-MM-DD]