Moment.js是一个轻量级的JavaScript时间库,它方便了日常开发中对时间的操作,提高了开发效率。日常开发中,通常会对时间进行下面这几个操作:比如获取时间,设置时间,格式化时间,比较时间等等。
一、引入moment.js
1.Node.js方式引入
(1)安装
● npm install moment
● yarn add moment
(2)引入
● require 方式
var moment = require('moment');
● import
方式 import moment from'moment';
2. 浏览器方式引入
二、 设定moment区域为中国
// require 方式
| require ('moment/locale/zh-cn') moment.locale('zh-cn'); |
复制
// import 方式
| import 'moment/locale/zh-cn'moment.locale('zh-cn'); |
复制
三、使用
1.获取时间
(1)获取当前时间
复制
(2)获取今天0时0分0秒
复制
(3)获取本周第一天(周日)0时0分0秒
复制
(4)获取本周周一0时0分0秒
| moment().startOf('isoWeek') |
复制
(5)获取当前月第一天0时0分0秒
| moment().startOf('month') |
复制
(6)获取今天23时59分59秒
复制
(7)获取本周最后一天(周六)23时59分59秒
复制
(8)获取本周周日23时59分59秒
| moment().endOf('isoWeek') |
复制
(9)获取当前月最后一天23时59分59秒
复制
(10)获取当前月的总天数
复制
(11)获取时间戳(以秒为单位)
| moment().format('X') |
| |
| moment().unix() |
复制
(12)获取时间戳(以毫秒为单位)
| moment().format('x') |
| |
| moment().valueOf() |
复制
(13)获取年份
| moment().year()moment().get('year') |
复制
(14)获取月份
| moment().month() |
| |
| moment().get('month') |
复制
(15)获取一个月中的某一天
| moment().date()moment().get('date') |
复制
(16)获取一个星期中的某一天
| moment().day() |
| |
| moment().weekday() |
| |
| moment().isoWeekday() |
| |
| moment().get('day') |
| |
| moment().get('weekday') |
| |
| moment().get('isoWeekday') |
复制
(17)获取小时
| moment().hours() |
| |
| moment().get('hours') |
复制
(18)获取分钟
| moment().minutes() |
| |
| moment().get('minutes') |
复制
(19)获取秒数
| moment().seconds() |
| moment().get('seconds') |
复制
(20)获取当前的年月日时分秒
| moment().toArray() |
| moment().toObject() |
复制
2. 设置时间
(1)设置年份
| moment().year(2019) |
| |
| moment().set('year',2019) |
| |
| moment().set({year:2019}) |
复制
(2)设置月份
| moment().month(11) |
| |
| moment().set('month',11) |
复制
(3)设置某个月中的某一天
| moment().date(15) |
| |
| moment().set('date',15) |
复制
(4)设置某个星期中的某一天
| 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) |
复制
(8)年份+1
| moment().add(1,'years') |
| |
| moment().add({years:1}) |
复制
(9)月份+1
复制
(10)日期+1
复制
(11)星期+1
复制
(12)小时+1
复制
(13)分钟+1
| moment().add(1,'minutes') |
复制
(14)秒数+1
| moment().add(1,'seconds') |
复制
(15)年份-1
| moment().subtract(1, 'years') |
| |
| moment().subtract({years: 1}) |
复制
(16)月份-1
| moment().subtract(1,'months') |
复制
(17)日期-1
| moment().subtract(1,'days') |
复制
(18)星期-1
| moment().subtract(1,'weeks') |
复制
(19)小时-1
| moment().subtract(1,'hours') |
复制
(20)分钟-1
| moment().subtract(1,'minutes') |
复制
(21)秒数-1
| moment().subtract(1,'seconds') |
复制
3.格式化时间
格式代码 | 说明 | 返回值例子 |
---|
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)格式化时间戳(以毫秒为单位)
复制
4.比较时间
(1)获取两个日期之间的时间差
| let start\_date =moment().subtract(1,'weeks') |
| |
| let end\_date = moment() |
| |
| end\_date.diff(start\_date) |
| |
| end\_date.diff(start\_date,'months') |
| |
| end\_date.diff(start\_date,'weeks') |
| |
| end\_date.diff(start\_date,'days') |
| |
| start\_date.diff(end\_date,'days') |
复制
(2)判断B日期是否在A日期前面
复制
5. 转化为JavaScript原生Date对象
| moment().toDate() |
| |
| newDate(moment()) |
复制
6.日期格式化
| moment().format('MMMM Do YYYY, h:mm:ss a'); |
| moment().format('dddd'); |
| |
| moment().format("MMM Do YY"); |
| |
| moment().format('YYYY \[escaped] YYYY'); |
| |
| moment().format(); |
复制
7.相对时间
| moment("20111031","YYYYMMDD").fromNow(); |
| |
| moment("20111031","YYYYMMDD").fromNow(true); |
| |
| moment().startOf('day').fromNow(); |
| |
| moment().endOf('day').fromNow(); |
| |
| moment().startOf('hour').fromNow(); |
复制
下表概述了每个时间长度显示的字符串的细分。
范围 | 键 | 样本输出 |
---|
0 至 44 秒 | s | 几秒前 |
未设定 | ss | 44 秒前 |
45 至 89 秒 | m | 1 分钟前 |
90 秒至 44 分钟 | mm | 2 分钟前 … 44 分钟前 |
45 至 89 分钟 | h | 1 小时前 |
90 分钟至 21 小时 | hh | 2 小时前 … 21 小时前 |
22 至 35 小时 | d | 1 天前 |
36 小时至 25 天 | dd | 2 天前 … 25 天前 |
26 至 45 天 | M | 1 个月前 |
45 至 319 天 | MM | 2 个月前 … 10 个月前 |
320 至 547 天 (1.5 年) | y | 1 年前 |
548 天+ | yy | 2 年前 … 20 年前 |
8.日历时间
| moment().subtract(n,'days').calendar(); |
| |
| moment().calendar(); |
| |
| moment().add(n,'days').calendar(); |
复制
9.多语言支持
| moment().format('L'); moment().format('l'); |
| |
| moment().format('LL'); moment().format('ll'); |
| |
| moment().format('LLL'); moment().format('lll'); |
| |
| moment().format('LLLL'); moment().format('llll'); |
复制
10.其它实用技巧:
| moment().format("YYYY-MM-DD") |
| |
| moment().subtract("month", +1).format("YYYY-MM")-01 |
| |
| moment().add("month", -1).format("YYYY-MM")-01 |
| |
| let M =`${moment().format("YYYY-MM")}-01` |
| |
| moment(M).add("days", -1).format("YYYY-MM-DD") |
| |
| moment().startOf("year").format("YYYY-MM-DD") |
| |
| moment().endOf("year").format("YYYY-MM-DD") |
| |
| moment().valueOf() |
| |
| moment(string).format() |
| |
| |
| |
| moment().utcOffset() |
| |
| Moment(date).utcOffset(480).format('YYYY-MM-DD HH:mm:ss'); |
| |
复制