MrZhujl

Moment.js是一个轻量级的JavaScript时间库,它方便了日常开发中对时间的操作,提高了开发效率。日常开发中,通常会对时间进行下面这几个操作:比如获取时间,设置时间,格式化时间,比较时间等等。下面就是我对moment.js使用过程中的整理,方便以后查阅。

一、引入moment.js

1.Node.js方式引入 (。◝‿◜。)

(1)安装

npm install moment 或者 yarn add moment

(2)引入

// require 方式
var moment = require(\'moment\');

// import 方式
import moment from \'moment\'; 

2.浏览器方式引入 ლ(╹◡╹ლ )

<script src="moment.js"></script>

二、设定moment区域为中国

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

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

三、使用

1.获取时间 Ⴚ(●ტ●)Ⴢ

(1)获取当前时间

moment()

(2)获取今天0时0分0秒

moment().startOf(\'day\')

(3)获取本周第一天(周日)0时0分0秒

moment().startOf(\'week\')

(4)获取本周周一0时0分0秒

moment().startOf(\'isoWeek\')

(5)获取当前月第一天0时0分0秒

moment().startOf(\'month\')

(6)获取今天23时59分59秒

moment().endOf(\'day\')

(7)获取本周最后一天(周六)23时59分59秒

moment().endOf(\'week\')

(8)获取本周周日23时59分59秒

moment().endOf(\'isoWeek\')

(9)获取当前月最后一天23时59分59秒

moment().endOf(\'month\')

(10)获取当前月的总天数

moment().daysInMonth() 

(11)获取时间戳(以秒为单位)

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

(12)获取时间戳(以毫秒为单位)

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

(13)获取年份

moment().year()
moment().get(\'year\')

(14)获取月份

moment().month()  // (0~11, 0: January, 11: December)
moment().get(\'month\')

(15)获取一个月中的某一天

moment().date()
moment().get(\'date\')

(16)获取一个星期中的某一天

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\')

(17)获取小时

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

(18)获取分钟

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

(19)获取秒数

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

(20)获取当前的年月日时分秒

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

2.设置时间 ︶ε╰✿

(1)设置年份

moment().year(2019)
moment().set(\'year\', 2019)
moment().set({year: 2019})

(2)设置月份

moment().month(11)  // (0~11, 0: January, 11: December)
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

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

(10)日期+1

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

(11)星期+1

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

(12)小时+1

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

(13)分钟+1

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

(14)秒数+1

moment().add(1, \'seconds\')
#### (15)年份-1
```js
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)格式化时间戳(以毫秒为单位)

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

4.比较时间 (◍\'౪`◍)ノ゙

(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

5.转化为JavaScript原生Date对象 ✿◡‿◡

moment().toDate()
new Date(moment())

6.日期格式化 ʅ(‾◡◝)ʃ 输出实例

moment().format(\'MMMM Do YYYY, h:mm:ss a\'); // 五月 24日 2019, 7:47:43 晚上
moment().format(\'dddd\');                    // 星期五
moment().format("MMM Do YY");               // 5月 24日 19
moment().format(\'YYYY [escaped] YYYY\');     // 2019 escaped 2019
moment().format();                          // 2019-05-24T19:47:43+08:00

7.相对时间 (◕ܫ◕) 输出实例

moment("20111031", "YYYYMMDD").fromNow(); // 8 年前
moment("20120620", "YYYYMMDD").fromNow(); // 7 年前
moment().startOf(\'day\').fromNow();        // 20 小时前
moment().endOf(\'day\').fromNow();          // 4 小时内
moment().startOf(\'hour\').fromNow();       // 1 小时前

8.日历时间 (๑¯ิε ¯ิ๑) 输出实例

moment().subtract(10, \'days\').calendar(); // 2019年5月14日
moment().subtract(6, \'days\').calendar();  // 上周六晚上7点49
moment().subtract(3, \'days\').calendar();  // 本周二晚上7点49
moment().subtract(1, \'days\').calendar();  // 昨天晚上7点49分
moment().calendar();                      // 今天晚上7点49分
moment().add(1, \'days\').calendar();       // 明天晚上7点49分
moment().add(3, \'days\').calendar();       // 下周一晚上7点49
moment().add(10, \'days\').calendar();      // 2019年6月3日

9.多语言支持 (๑´ڡ`๑) 输出实例

moment().format(\'L\');    // 2019-05-24
moment().format(\'l\');    // 2019-05-24
moment().format(\'LL\');   // 2019年5月24日
moment().format(\'ll\');   // 2019年5月24日
moment().format(\'LLL\');  // 2019年5月24日晚上7点50分
moment().format(\'lll\');  // 2019年5月24日晚上7点50分
moment().format(\'LLLL\'); // 2019年5月24日星期五晚上7点50分
moment().format(\'llll\'); // 2019年5月24日星期五晚上7点50分

10.其它实用技巧 (•‾̑⌣‾̑•)✧˖° 输出实例:

moment().format("YYYY-MM-DD") // 格式化显示当前时间
`${moment().subtract("month", +1).format("YYYY-MM")}-01` // 上一个月的1号
`${moment().add("month", -1).format("YYYY-MM")}-01`  // 还是上一个月1号 
let M = `${moment().format("YYYY-MM")}-01` // 本月一号
moment(M).add("days", -1).format("YYYY-MM-DD") // 上一个月月底 
moment().startOf("year").format("YYYY-MM-DD")  // 本年的的开始日期,("2019-01-01")
moment().endOf("year").format("YYYY-MM-DD")  // 本年的的结束日期,("2019-12-31")
// moment 转成时间戳
moment().valueOf()
// 时间戳 转 moment
moment(string).format()

// 解决Moment格式化时间出现时区差的问题
// `utcOffset()` 接收数字,时间偏移量,单位:分钟
// 北京时间东八区时间,比零时区早8个小时(480分钟),所以应该加上480分钟
Moment(date).utcOffset(480).format(\'YYYY-MM-DD HH:mm:ss\');

更多可参见官方文档:http://momentjs.cn/docs/

分类:

技术点:

相关文章: