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秒

    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

时间转换成数值

moment.duration('1:30').asHours(); //will return 1.5

数值格式化成时间

moment.utc().startOf('day').add({ minutes: 90 }).format('H:mm');

附录

	令牌	输出
月份	M	1 2 ... 11 12
	Mo	1st 2nd ... 11th 12th
	MM	01 02 ... 11 12
	MMM	Jan Feb ... Nov Dec
	MMMM	January February ... November December
季度	Q	1 2 3 4
	Qo	1st 2nd 3rd 4th
月份的日期	D	1 2 ... 30 31
	Do	1st 2nd ... 30th 31st
	DD	01 02 ... 30 31
年份的日期	DDD	1 2 ... 364 365
	DDDo	1st 2nd ... 364th 365th
	DDDD	001 002 ... 364 365
星期几	d	0 1 ... 5 6
	do	0th 1st ... 5th 6th
	dd	Su Mo ... Fr Sa
	ddd	Sun Mon ... Fri Sat
	dddd	Sunday Monday ... Friday Saturday
星期几（语言环境）	e	0 1 ... 5 6
星期几（ISO）	E	1 2 ... 6 7
年份的星期	w	1 2 ... 52 53
	wo	1st 2nd ... 52nd 53rd
	ww	01 02 ... 52 53
年份的星期（ISO）	W	1 2 ... 52 53
	Wo	1st 2nd ... 52nd 53rd
	WW	01 02 ... 52 53
年份	YY	70 71 ... 29 30
	YYYY	1970 1971 ... 2029 2030
	Y	1970 1971 ... 9999 +10000 +10001 注意：对于 9999 年以后的日期，这符合 ISO 8601 标准。
周年	gg	70 71 ... 29 30
	gggg	1970 1971 ... 2029 2030
周年（ISO）	GG	70 71 ... 29 30
	GGGG	1970 1971 ... 2029 2030
子午线	A	AM PM
	a	am pm
小时	H	0 1 ... 22 23
	HH	00 01 ... 22 23
	h	1 2 ... 11 12
	hh	01 02 ... 11 12
	k	1 2 ... 23 24
	kk	01 02 ... 23 24
分钟	m	0 1 ... 58 59
	mm	00 01 ... 58 59
秒钟	s	0 1 ... 58 59
	ss	00 01 ... 58 59
小数秒钟	S	0 1 ... 8 9
	SS	00 01 ... 98 99
	SSS	000 001 ... 998 999
	SSSS ... SSSSSSSSS	000[0..] 001[0..] ... 998[0..] 999[0..]
时区	z or zz	EST CST ... MST PST 注意：从 1.6.0 版本开始，z/zz 格式的令牌已从普通的 moment 对象中弃用。 在此处了解更多信息。 但是，如果将特定时区与 moment-timezone 插件一起使用，它们会起作用。
	Z	-07:00 -06:00 ... +06:00 +07:00
	ZZ	-0700 -0600 ... +0600 +0700
Unix 时间戳	X	1360013296
Unix 毫秒时间戳	x	1360013296123

键	快捷键
years	y
quarters	Q
months	M
weeks	w
days	d
hours	h
minutes	m
seconds	s
milliseconds	ms