moment.min.js_Moment.js教程
moment.min.js
Moment.js is an awesome JavaScript library that helps you manage dates, in the browser and in Node.js as well.
Moment.js是一个很棒JavaScript库，可帮助您在浏览器和Node.js中管理日期。
This article aims to explain the basics and the most common usages of this library.
本文旨在解释该库的基础知识和最常用的用法。
安装 (Installation)
You can include it directly in your page using a script tag, from unpkg.com:
您可以使用脚本标签直接从unpkg.com将其包含在页面中：
or using npm:
或使用npm ：
npm install momentIf you install using npm you need to import the package (using ES Modules):
如果使用npm安装，则需要导入软件包(使用ES Modules )：
import moment from 'moment'or require it (using CommonJS):
或要求它(使用CommonJS )：
const moment = require('moment')获取当前日期和时间 (Get the current date and time)
const date = moment()解析日期 (Parse a date)
A moment object can be initialized with a date by passing it a string:
可以通过将一个字符串对象传递给一个日期来对其进行初始化：
const date = moment(string)it accepts any string, parsed according to (in order):
它接受根据(按顺序)解析的任何字符串：
ISO 8601
ISO 8601
The RFC 2822 Date Time format
RFC 2822日期时间格式
- the formats accepted by the Date object Date对象接受的格式
ISO 8601 is definitely the most convenient. Here’s a format reference:
ISO 8601绝对是最方便的。 这是格式参考：
| Format | Meaning | Example |
|---|---|---|
| YYYY | 4-digits Year | 2018 |
| YY | 2-digits Year | 18 |
| M | 2-digits Month number, omits leading 0 | 7 |
| MM | 2-digits Month number | 07 |
| MMM | 3-letters Month name | Jul |
| MMMM | Full Month name | July |
| dddd | Full day name | Sunday |
| gggg | 4-digits Week year | 2018 |
| gg | 2-digits Week year | 18 |
| w | Week of the year without leading zero | 18 |
| ww | Week of the year with leading zero | 18 |
| e | Day of the week, starts at 0 | 4 |
| D | 2-digits day number, omits leading 0 | 9 |
| DD | 2-digits day number | 09 |
| Do | Day number with ordinal | 9th |
| T | Indicates the start of the time part | |
| HH | 2-digits hours (24 hour time) from 0 to 23 | 22 |
| H | 2-digits hours (24 hour time) from 0 to 23 without leading 0 | 22 |
| kk | 2-digits hours (24 hour time) from 1 to 24 | 23 |
| k | 2-digits hours (24 hour time) from 1 to 24 without leading 0 | 23 |
| a/A | am or pm |
pm |
| hh | 2-digits hours (12 hour time) | 11 |
| mm | 2-digits minutes | 22 |
| ss | 2-digits seconds | 40 |
| s | 2-digits seconds without leading zero | 40 |
| S | 1-digits milliseconds | 1 |
| SS | 2-digits milliseconds | 12 |
| SSS | 3-digits milliseconds | 123 |
| Z | The timezone | +02:00 |
| x | UNIX timestamp in milliseconds | 1410432140575 |
| 格式 | 含义 | 例 |
|---|---|---|
| YYYY | 4位数字年份 | 2018年 |
| YY | 两位数年份 | 18 |
| 中号 | 2位数字月份号，省略前导0 | 7 |
| MM | 2位数字月份号 | 07 |
| MMM | 3个字母的月份名称 | 七月 |
| MMMM | 全月名称 | 七月 |
| dddd | 全日名称 | 星期日 |
| gggg | 4位数字的周年 | 2018年 |
| gg | 2位数字的星期年 | 18 |
| w | 一年中的星期，不带零 | 18 |
| w | 一年中的前零周 | 18 |
| Ë | 星期几，从0开始 | 4 |
| d | 2位日数字，省略前导0 | 9 |
| DD | 2位数的日号 | 09 |
| 做 | 带序号的天数 | 第九名 |
| Ť | 指示时间部分的开始 | |
| H | 2位数小时(24小时制)，从0到23 | 22 |
| H | 2位数小时(24小时制)，从0到23，前导0 | 22 |
| kk | 2位数小时(24小时制)，从1到24 | 23 |
| ķ | 2位数小时(24小时制)，从1到24，不加0 | 23 |
| A / A | am或pm |
下午 |
| h | 2位数小时(12小时制) | 11 |
| 毫米 | 2位数字分钟 | 22 |
| ss | 2位数秒 | 40 |
| s | 2位秒，不带前导零 | 40 |
| 小号 | 1位数毫秒 | 1个 |
| SS | 2位毫秒 | 12 |
| SSS | 3位数毫秒 | 123 |
| ž | 时区 | +02：00 |
| X | UNIX时间戳(以毫秒为单位) | 1410432140575 |
设定日期 (Set a date)
格式化日期 (Format a date)
When you want to output the content of a plain JavaScript Date object, you have little options to determine the formatting. All you can do is to use the built-in methods, and compose the date as you want using them.
当您要输出纯JavaScript Date对象的内容时，几乎没有选择来确定格式。 您所能做的就是使用内置方法，并根据需要编写日期。
Moment offers a handy way to format the date according to your needs, using the format() method:
Moment提供了一种方便的方式，可以使用format()方法根据您的需要格式化日期：
date.format(string)The string format accepts the same formats I described in the “Parse a date” section above.
字符串格式接受与我上面“解析日期”一节中描述的格式相同的格式。
Example:
例：
moment().format("YYYY Do MM")Moment provides some constants you can use instead of writing your own format:
Moment提供了一些常量，您可以使用它们来代替编写自己的格式：
| Constant | Format | Example |
|---|---|---|
moment.HTML5_FMT.DATETIME_LOCAL |
YYYY-MM-DDTHH:mm | 2017-12-14T16:34 |
moment.HTML5_FMT.DATETIME_LOCAL_SECONDS |
YYYY-MM-DDTHH:mm:ss | 2017-12-14T16:34:10 |
moment.HTML5_FMT.DATETIME_LOCAL_MS |
YYYY-MM-DDTHH:mm:ss.SSS | 2017-12-14T16:34:10.234 |
moment.HTML5_FMT.DATE |
YYYY-MM-DD | 2017-12-14 |
moment.HTML5_FMT.TIME |
HH:mm | 16:34 |
moment.HTML5_FMT.TIME_SECONDS |
HH:mm:ss | 16:34:10 |
moment.HTML5_FMT.TIME_MS |
HH:mm:ss.SSS | 16:34:10.234 |
moment.HTML5_FMT.WEEK |
YYYY-[W]WW | 2017-W50 |
moment.HTML5_FMT.MONTH |
YYYY-MM | 2017-12 |
| 不变 | 格式 | 例 |
|---|---|---|
moment.HTML5_FMT.DATETIME_LOCAL |
YYYY-MM-DDTHH：mm | 2017-12-14T16：34 |
moment.HTML5_FMT.DATETIME_LOCAL_SECONDS |
YYYY-MM-DDTHH：mm：ss | 2017-12-14T16：34：10 |
moment.HTML5_FMT.DATETIME_LOCAL_MS |
YYYY-MM-DDTHH：mm：ss.SSS | 2017-12-14T16：34：10.234 |
moment.HTML5_FMT.DATE |
YYYY-MM-DD | 2017-12-14 |
moment.HTML5_FMT.TIME |
高度：毫米 | 16:34 |
moment.HTML5_FMT.TIME_SECONDS |
HH：mm：ss | 16:34:10 |
moment.HTML5_FMT.TIME_MS |
HH：mm：ss.SSS | 16：34：10.234 |
moment.HTML5_FMT.WEEK |
YYYY- [W] WW | 2017-W50 |
moment.HTML5_FMT.MONTH |
YYYY-MM | 2017-12 |
验证日期 (Validating a date)
Any date can be checked for validity using the isValid() method:
可以使用isValid()方法检查任何日期的有效性：
moment('2018-13-23').isValid() //false
moment('2018-11-23').isValid() //true时间以前，直到日期 (Time ago, time until date)
Use fromNow(). Strings are localized:
使用fromNow() 。 字符串已本地化：
moment('2016-11-23').fromNow() //2 years ago
moment('2018-05-23').fromNow() //a month ago
moment('2018-11-23').fromNow() //in 5 monthsif you pass true to fromNow(), it just shows the difference, without reference to future/past.
如果将true传递给fromNow()，它将仅显示差异，而不会引用future / past。
moment('2016-11-23').fromNow(true) //2 years
moment('2018-05-23').fromNow(true) //a month
moment('2018-11-23').fromNow(true) //5 months处理日期 (Manipulate a date)
You can add or subtract any amount of time to a date:
您可以在日期中增加或减少任何时间：
moment('2016-11-23').add(1, 'years')
moment('2016-11-23').subtract(1, 'years')You can use those values:
您可以使用这些值：
yearsyearsquartersquartersmonthsmonthsweeksweeksdaysdayshourshoursminutesminutessecondssecondsmillisecondsmilliseconds
翻译自: https://flaviocopes.com/momentjs/
moment.min.js