JS常用时间操作moment.js参考文档
文章目录
-
- 一、引入moment.js
-
- 1.Node.js方式引入
- 2.浏览器方式引入
- 二、moment时区和转换
-
- 1.时区的设置
- 2.UTC和北京时间的互转
- 三、使用
-
- 1.获取时间
- 2.设置时间
- 3.格式化时间
- 4.比较时间
- 5.转化为JavaScript原生Date对象
- 6.日期格式化
- 7.相对时间输出实例
- 8.日历时间输出实例
- 9.多语言支持输出实例
- 10.其它实用技巧
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时区和转换
1.时区的设置
// require 方式
require('moment/locale/zh-cn')
moment.locale('zh-cn');
// import 方式
import 'moment/locale/zh-cn'
moment.locale('zh-cn');
//使用utc时区,后面可继续添加相关获取时间或格式化操作
moment.utc()
2.UTC和北京时间的互转
2.1 目标是UTC时间，则用moment(utcTime).utc()方法，举例：
moment(utcTime).utc().format('YYYY-MM-DD HH:mm:ss')
2.2 目标是北京时间，则用moment(utcTime).utcOffset(8)方法，举例：
moment(utcTime).utcOffset(8).format('YYYY/MM/DD HH:mm:ss')
三、使用
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
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.js 中文网