Moment.js 常见用法总结

Moment.js是一个时间日期库，它方便了日常开发中对时间的操作，提高了开发效率。

结合官网及其他资料，对Moment. js的常见用法做了简单的总结，方便后续的查阅与使用。

一、引入

1、nodejs

（1）安装

// 通过npm安装
npm install moment --save   

// 通过yarn安装
yarn add moment             

（2）使用方法

// 使用require
var moment = require('moment');
moment().format();

// 使用import
import moment from 'moment';
moment().format();

（3）设置语言环境

// require 方式
require('moment/locale/zh-cn')
moment.locale('zh-cn'); 

// import 方式
import 'moment/locale/zh-cn'
moment.locale('zh-cn'); 

2、浏览器

二、使用

1、获取时间

（1）获取当前时间

// 比如当前时间是 2021-06-12
// 注意这里是moment的格式，获取的是当前时间
moment()

（2）获取一个月中的某一天

// 比如当前日期是 2021-06-12
moment().date()  // 默认的是当前日 12  
moment().get('date')   // 12

 （3）获取月份

// 比如当前日期是 2021-06-12

// 默认获取当前月份，由于是从0开始的，这里得到的是 5
moment().month() 
moment().get('month')

（4）获取年份

// 比如当前时间是 2021-06-12，得到的是2021
// 用法和月份相似，这里不再列举
moment().year()
moment().get('year')

（5）获取一个星期中的某一天

// 获取星期几，如果超出范围，则它将会冒泡到其他星期
moment().day() // (0~6, 0: Sunday, 6: Saturday)
moment().get('day')

// 如果语言环境将星期一指定为一周的第一天，则 moment().weekday(0) 将会是星期一。 
// 如果星期日是一周的第一天，则 moment().weekday(0) 将会是星期日。
moment().weekday() // (0~6, 0: Sunday, 6: Saturday)
moment().get('weekday')

moment().isoWeekday() // (1~7, 1: Monday, 7: Sunday)
moment().get('isoWeekday')

（6）获取小时

moment().hours()
moment().get('hours')

 （7）获取分钟

moment().minutes()
moment().get('minutes')

（8）获取秒数

moment().seconds()
moment().get('seconds')

 （9）获取当前的年月日时分秒

moment().toArray() // [years, months, date, hours, minutes, seconds, milliseconds]
moment().toObject() // {years: xxxx, months: x, date: xx ...}

（10）获取今天的0时0分0秒

moment().startOf('day')

 （11）获取本周第一天(周日)

moment().startOf('week')

（12）获取本周周一

moment().startOf('isoWeek')

 （13）获取当前月第一天

moment().startOf('month')

（14）获取今天23时59分59秒

moment().endOf('day')

 （15）获取本周最后一天(周六)

moment().endOf('week')

（16）获取本周周日

moment().endOf('isoWeek')

 （17）获取当前月最后一天

moment().endOf('month')

（18）获取当前月的总天数

moment().daysInMonth() 

 （19）获取时间戳(以秒为单位)

moment().format('X') // 返回值为字符串类型
moment().unix() // 返回值为数值型

（20）获取时间戳(以毫秒为单位)

moment().format('x') // 返回值为字符串类型
moment().valueOf() // 返回值为数值型

 2、set时间

（1）设置某个月的某一天

moment().date(15)
moment().set('date', 15)

// 注意：这里输出的是moment的时间格式
moment().date(23)

// 超出当月日期范围，会往后推，6月有30天，往后一天就是7月1号
moment().date(31)

// 格式化处理（下面会讲）
moment().date(23).format('YYYY-MM-DD')  
// "2021-06-23"

moment().date(31).format('YYYY-MM-DD')  
// "2021-07-01"

moment().date(32).format('YYYY-MM-DD')  
// "2021-07-02"

（2）设置月份

// 设置月份为12月
moment().month(11)  // (0~11, 0: January, 11: December)
moment().set('month', 11) 

// moment格式
moment().month(7)

// 正常的月份范围是0~11，超出会往后面推
moment().month(12)

moment().month(7).format('YYYY-MM')
// "2021-08"

moment().month(12).format('YYYY-MM')
// "2022-01"

moment().month(13).format('YYYY-MM')
// "2022-02"

（3）设置年份

// 设置年份为2021年
moment().year(2021)
moment().set('year', 2021)
moment().set({year: 2021})

（4）设置一个星期中的某一天

moment().day(1) // 设置日期为本周星期一
moment().weekday(0) // 设置日期为本周第一天（周日）
moment().isoWeekday(1) // 设置日期为本周周一
moment().set('weekday', 0)
moment().set('isoWeekday', 1)

（5）设置小时

moment().hours(12)
moment().set('hours', 12)

（6）设置分钟

moment().minutes(30)
moment().set('minutes', 30)

（7）设置秒数

moment().seconds(30)
moment().set('seconds', 30)

3、add时间

（1）年份+1

moment().add(1, 'years')
moment().add({years: 1})

（2）月份+1

moment().add(1, 'months')

（3）日期+1

moment().add(1, 'days')

（4）星期+1

moment().add(1, 'weeks')

（5）小时+1

moment().add(1, 'hours')

（6）分钟+1

moment().add(1, 'minutes')

（7）秒+1

moment().add(1, 'seconds')

4、subtract时间

（1）年份-1

moment().subtract(1, 'years')
moment().subtract({years: 1})

（2）月份-1

moment().subtract(1, 'months')

（3）日期-1

moment().subtract(1, 'days')

（5）星期-1

moment().subtract(1, 'weeks')

（6）小时-1

moment().subtract(1, 'hours')

（7）分钟-1

moment().subtract(1, 'minutes')

（8）秒-1

moment().subtract(1, 'seconds')

三、日期格式化

格式代码	说明	返回值例子
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、格式化年月日： 'xxxx年xx月xx日'

moment().format('YYYY年MM月DD日')

2、格式化年月日： 'xxxx-xx-xx'

moment().format('YYYY-MM-DD')

3、格式化时分秒(24小时制)： 'xx时xx分xx秒'

moment().format('HH时mm分ss秒')

4、格式化时分秒(12小时制)：'xx:xx:xx am/pm'

moment().format('hh:mm:ss a')

5、格式化时间戳(以秒为单位)

moment().format('X') // 返回值为字符串类型

6、格式化时间戳(以毫秒为单位)

moment().format('x') // 返回值为字符串类型

四、比较时间

1、获取两个日期之间的时间差

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

2、判断一个日期是否在另一个日期之前

// 第一个参数会被解析为moment（如果尚未解析）
moment('2010-10-20').isBefore('2010-10-21');  // true

moment().isBefore('2010-10-21');  // false
moment().isBefore('2021-10-21');  // true

// 如果要将粒度限制为毫秒以外的单位，则将单位作为第二个参数传入
// 如下，只比较年度
moment('2010-10-20').isBefore('2010-12-31', 'year'); // false
moment('2010-10-20').isBefore('2011-01-01', 'year'); // true

// 注意：moment().isBefore() 具有未定义的行为，且不应被使用！

3、判断一个日期是否等于另一个日期

moment('2010-10-20').isSame('2010-10-20'); // true

// 单独比较年度
moment('2010-10-20').isSame('2009-12-31', 'year');  // false
moment('2010-10-20').isSame('2010-01-01', 'year');  // true
moment('2010-10-20').isSame('2010-12-31', 'year');  // true
moment('2010-10-20').isSame('2011-01-01', 'year');  // false

4、判断一个日期是否在另一个日期之后

moment('2010-10-20').isAfter('2010-10-19'); // true

moment('2010-10-20').isAfter('2010-01-01', 'year'); // false
moment('2010-10-20').isAfter('2009-12-31', 'year'); // true

五、其他

1、将moment转换为JavaScript原生Date对象

let m = moment()
let nativeDate1 = m.toDate()
let nativeDate2 = new Date(m)

String(nativeDate1) === String(nativeDate2) // true

2、检查变量是否为原生 js Date 对象

// 传入obj
moment.isDate(obj);

// 示例如下
moment.isDate(); // false
moment.isDate(new Date()); // true
moment.isDate(moment()); // false