format()
编辑教程format()
moment().format();
moment().format(String);
这是最稳健的显示选项。 它接受一串令牌并将其替换为其相应的值。
moment().format(); // "2014-09-08T08:02:17-05:00" (ISO 8601,无小数秒钟)
moment().format("dddd, MMMM Do YYYY, h:mm:ss a"); // "Sunday, February 14th 2010, 3:25:50 pm"
moment().format("ddd, hA"); // "Sun, 3PM"
moment('gibberish').format('YYYY MM DD'); // "Invalid date"
令牌 | 输出 | |
---|---|---|
月份 | M | 1 2 ... 11 12 |
Mo | 1st 2nd ... 11th 12th | |
MM | 01 02 ... 11 12 | |
MMM | Jan Feb ... Nov Dec | |
MMMM | January February ... November December | |
季度 | Q | 1 2 3 4 |
Qo | 1st 2nd 3rd 4th | |
月份的日期 | D | 1 2 ... 30 31 |
Do | 1st 2nd ... 30th 31st | |
DD | 01 02 ... 30 31 | |
年份的日期 | DDD | 1 2 ... 364 365 |
DDDo | 1st 2nd ... 364th 365th | |
DDDD | 001 002 ... 364 365 | |
星期几 | d | 0 1 ... 5 6 |
do | 0th 1st ... 5th 6th | |
dd | Su Mo ... Fr Sa | |
ddd | Sun Mon ... Fri Sat | |
dddd | Sunday Monday ... Friday Saturday | |
星期几(语言环境) | e | 0 1 ... 5 6 |
星期几(ISO) | E | 1 2 ... 6 7 |
年份的星期 | w | 1 2 ... 52 53 |
wo | 1st 2nd ... 52nd 53rd | |
ww | 01 02 ... 52 53 | |
年份的星期(ISO) | W | 1 2 ... 52 53 |
Wo | 1st 2nd ... 52nd 53rd | |
WW | 01 02 ... 52 53 | |
年份 | YY | 70 71 ... 29 30 |
YYYY | 1970 1971 ... 2029 2030 | |
Y | 1970 1971 ... 9999 +10000 +10001 注意:对于 9999 年以后的日期, 这符合 ISO 8601 标准。 |
|
周年 | gg | 70 71 ... 29 30 |
gggg | 1970 1971 ... 2029 2030 | |
周年(ISO) | GG | 70 71 ... 29 30 |
GGGG | 1970 1971 ... 2029 2030 | |
子午线 | A | AM PM |
a | am pm | |
小时 | H | 0 1 ... 22 23 |
HH | 00 01 ... 22 23 | |
h | 1 2 ... 11 12 | |
hh | 01 02 ... 11 12 | |
k | 1 2 ... 23 24 | |
kk | 01 02 ... 23 24 | |
分钟 | m | 0 1 ... 58 59 |
mm | 00 01 ... 58 59 | |
秒钟 | s | 0 1 ... 58 59 |
ss | 00 01 ... 58 59 | |
小数秒钟 | S | 0 1 ... 8 9 |
SS | 00 01 ... 98 99 | |
SSS | 000 001 ... 998 999 | |
SSSS | ... SSSSSSSSS 000[0..] 001[0..] ... 998[0..] 999[0..] | |
时区 | z or zz | EST CST ... MST PST 注意:从 1.6.0 版本开始, z/zz 格式的令牌已从普通的 moment 对象中弃用。 但如果将特定时区与 moment-timezone 插件一起使用,它们会起作用。 |
Z | -07:00 -06:00 ... +06:00 +07:00 | |
ZZ | -0700 -0600 ... +0600 +0700 | |
Unix 时间戳 | X | 1360013296 |
Unix 毫秒时间戳 | x | 1360013296123 |
X 新增于 2.0.0。
e E gg gggg GG GGGG 新增于 2.1.0。
x 新增于 2.8.4。
SSSS 至 SSSSSSSSS 新增于 2.10.5。 它们会显示 3 位有效数字,其余部分用零填充。
k 和 kk 新增于 2.13.0。
本地化格式
由于首选的格式会根据语言环境而有所不同,因此有一些令牌可用于根据语言环境格式 moment。
同一格式有大小写变体。 小写版本旨在作为大写版本的简化版本。
时间 | LT | 8:30 PM |
---|---|---|
带秒钟的时间 | LTS | 8:30:25 PM |
月份数字,月份日期,年份 | L | 09/04/1986 |
l | 9/4/1986 | |
月份名称,月份日期,年份 | LL | September 4, 1986 |
ll | Sep 4, 1986 | |
月份名称,月份日期,年份,时间 | LLL | September 4, 1986 8:30 PM |
lll | Sep 4, 1986 8:30 PM | |
月份名称,月份日期,星期几,年份,时间 | LLLL | Thursday, September 4, 1986 8:30 PM |
llll | Thu, Sep 4, 1986 8:30 PM |
l ll lll llll 在 2.0.0 中可用。 LTS 新增于 2.8.4。
转义字符
要转义格式字符串中的字符,可以将字符包装在方括号中。
moment().format('[今天] dddd'); // '今天 Sunday'
与 LDML 的异同
注意:虽然这些日期格式与 LDML 日期格式非常相似,但是在月份的日期、年份的日期、星期几等方面存在一些细微的差异。
有关跨不同语言环境的一些不同的日期格式令牌的详细信息,参阅日期格式令牌的图表。
格式化速度
要与其他库比较 Moment.js 的格式化速度,请差异与其他库的比较。
其他令牌
如果更习惯使用 strftime 而不是类似 LDML 的解析令牌,则可以使用 Ben Oakes 的插件 benjaminoakes/moment-strftime。
默认的格式
不使用格式调用 moment#format 将会默认为 moment.defaultFormat。 开箱即用的 moment.defaultFormat 是 ISO8601 格式 YYYY-MM-DDTHH:mm:ssZ。
从 2.13.0 版本开始,当在 UTC 模式中时,默认的格式由 moment.defaultFormatUtc 管理的,其格式是 YYYY-MM-DDTHH:mm:ss[Z]。 这会返回 Z 作为偏移量,而不是 +00:00。
在某些情况下,本地时区(例如 Atlantic/Reykjavik)可能具有零偏移量,且将会被视为 UTC。 在这种情况下,将 moment.defaultFormat 和 moment.defaultFormatUtc 设置为使用相同的格式可能很有用。
更改 moment.defaultFormat 的值仅会影响格式化,而不会影响解析。 例如:
moment.defaultFormat = "DD.MM.YYYY HH:mm";
// 使用 .toDate() 解析。
moment('20.07.2018 09:19').toDate() // Invalid date
// 使用新的 defaultFormat 格式化日期字符串,然后解析。
moment('20.07.2018 09:19', moment.defaultFormat).toDate() // Fri Jul 20 2018 09:19:00 GMT+0300
选择支付方式:
备注:
转账时请填写正确的金额和备注信息,到账由人工处理,可能需要较长时间