使用moment.js轻松管理日期和时间

格式化日期

moment().format('YYYY-MM-DD HH:mm:ss'); //2014-09-24 23:36:09

moment().format('d'); //3

moment().format('X');

相对时间

moment("20120901", "YYYYMMDD").fromNow(); //2 years ago

moment().add('days',7).format('YYYY年MM月DD日'); //2014年10月01日

moment().add('hours',9).format('HH:mm:ss');

当前时间 1.0.0+

moment();

var now = moment();

moment(String);

new Date(string)

var day = moment("1995-12-25");

Supported ISO 8601 strings

2013-02-08  # A calendar date part
2013-W06-5  # A week date part
2013-039    # An ordinal date part

2013-02-08T09            # An hour time part separated by a T
2013-02-08 09            # An hour time part separated by a space
2013-02-08 09:30         # An hour and minute time part
2013-02-08 09:30:26      # An hour, minute, and second time part
2013-02-08 09:30:26.123  # An hour, minute, second, and millisecond time part
2013-02-08 24:00:00.000  # hour 24, minute, second, millisecond equal 0 means next day at midnight

2013-02-08 09  # A calendar date part and hour time part
2013-W06-5 09  # A week date part and hour time part
2013-039 09    # An ordinal date part and hour time part

+-HH:mm

+-HHmm

Z

2013-02-08 09+07:00            # +-HH:mm
2013-02-08 09-0100             # +-HHmm
2013-02-08 09Z                 # Z
2013-02-08 09:30:26.123+07:00  # +-HH:mm

Date.parse

moment#isValid

moment("not a real date").isValid(); // fals
e

字符串 + 格式 1.0.0+

moment(String, String);
moment(String, String, String);
moment(String, String, Boolean);
moment(String, String, String, Boolean);

moment("12-25-1995", "MM-DD-YYYY");

moment("12-25-1995", "MM-DD-YYYY");
moment("12/25/1995", "MM-DD-YYYY");

moment#format

Year, month, and day tokens

YYYY

2014

YY

14

Q

1..4

M MM

1..12

MMM MMMM

Jan..December

moment.locale()

D DD

1..31

Do

1st..31st

DDD DDDD

1..365

X

1410715640.579

x

1410715640579

YYYY

2.10.5

YY

Week year, week, and weekday tokens

gggg

2014

gg

14

w ww

1..53

e

1..7

ddd dddd

Mon...Sunday

moment.locale()

GGGG

2014

GG

14

W WW

1..53

E

1..7

Hour, minute, second, millisecond, and offset tokens

H HH

0..23

h hh

1..12

a A

a A

am pm

m mm

0..59

s ss

0..59

S

0..9

SS

0..99

SSS

0..999

SSSS

0000..9999

Z ZZ

+12:00

+-HH:mm

+-HHmm

Z

LT LTS L LL LLL LLLL

LTS

Z ZZ

1.2.0

S SS SSS

1.6.0

X

2.0.0

moment("2010-10-20 4:30",       "YYYY-MM-DD HH:mm");   // parsed as 4:30 local time
moment("2010-10-20 4:30 +0000", "YYYY-MM-DD HH:mm Z"); // parsed as 4:30 UTC

moment#isValid

moment("2010 13",           "YYYY MM").isValid();     // false (not a real month)
moment("2010 11 31",        "YYYY MM DD").isValid();  // false (not a real day)
moment("2010 2 29",         "YYYY MM DD").isValid();  // false (not a leap year)
moment("2010 notamonth 29", "YYYY MMM DD").isValid(); // false (not a real month name)

2.0.0

moment()

moment.utc()

moment('2012 juillet', 'YYYY MMM', 'fr');
moment('2012 July',    'YYYY MMM', 'en');

2.3.0

moment('It is 2012-05-25', 'YYYY-MM-DD').isValid();       // true
moment('It is 2012-05-25', 'YYYY-MM-DD', true).isValid(); // false
moment('2012-05-25',       'YYYY-MM-DD', true).isValid(); // true

moment('2012-10-14', 'YYYY-MM-DD', 'fr', true);

Parsing two digit years

moment.parseTwoDigitYear

字符串 + 多个格式 1.0.0+

moment(String, String[], String, Boolean);

moment("12-25-1995", ["MM-DD-YYYY", "YYYY-MM-DD"]);

2.3.0

moment("29-06-1995", ["MM-DD-YYYY", "DD-MM", "DD-MM-YYYY"]); // uses the last format
moment("05-06-1995", ["MM-DD-YYYY", "DD-MM-YYYY"]);          // uses the first format

moment("29-06-1995", ["MM-DD-YYYY", "DD-MM-YYYY"], 'fr');       // uses 'fr' locale
moment("29-06-1995", ["MM-DD-YYYY", "DD-MM-YYYY"], true);       // uses strict parsing
moment("05-06-1995", ["MM-DD-YYYY", "DD-MM-YYYY"], 'fr', true); // uses 'fr' locale and strict parsing

字符串特殊格式 2.7.0+

moment(String, moment.CUSTOM_FORMAT, [String], [Boolean]);
moment(String, [..., moment.ISO_8601, ...], [String], [Boolean]);

moment.ISO_8601

moment("2010-01-01T05:06:07", moment.ISO_8601);
moment("2010-01-01T05:06:07", ["YYYY", moment.ISO_8601]);

对象 2.2.1+

moment({unit: value, ...});

moment({ hour:15, minute:10 });
moment({ y    :2010, M     :3, d   :5, h    :15, m      :10, s      :3, ms          :123});
moment({ year :2010, month :3, day :5, hour :15, minute :10, second :3, millisecond :123});
moment({ years:2010, months:3, days:5, hours:15, minutes:10, seconds:3, milliseconds:123});
moment({ years:2010, months:3, date:5, hours:15, minutes:10, seconds:3, milliseconds:123});

day

date

date

moment(Array)

new
Date(year, month, date)

Unix 偏移量 (毫秒) 1.0.0+

moment(Number);

new Date(Number)

var day = moment(1318781876406);

Unix 时间戳 (秒) 1.6.0+

moment.unix(Number)

moment.unix(Number)

var day = moment.unix(1318781876);

moment(timestamp * 1000)

var day = moment.unix(1318781876.721);

Date 对象 1.0.0+

moment(Date);

Moment

Date

var day = new Date(2011, 9, 16);
var dayWrapper = moment(day);

Date

Date

Moment

数组 1.0.0+

moment(Number[]);

[year, month, day, hour, minute, second, millisecond]
moment([2010, 1, 14, 15, 25, 50, 125]); // February 14th, 3:25:50.125 PM

moment([2010]);        // January 1st
moment([2010, 6]);     // July 1st
moment([2010, 6, 10]); // July 10th

moment.utc(Number[])

moment.utc([2010, 1, 14, 15, 25, 50, 125]);

Date

moment#isValid

moment([2010, 13]).isValid();     // false (not a real month)
moment([2010, 10, 31]).isValid(); // false (not a real day)
moment([2010, 1, 29]).isValid();  // false (not a leap year)

ASP.NET 1.3.0+

moment(String);

/Date(1198908717056)/

/Date(1198908717056-0700)/

moment("/Date(1198908717056-0700)/"); // 2007-12-28T23:11:57.056-07:00

克隆 1.2.0+

moment(Moment);

moment()

var a = moment([2012]);
var b = moment(a);
a.year(2000);
b.year(); // 2012

moment#clone

var a = moment([2012]);
var b = a.clone();
a.year(2000);
b.year(); // 2012

UTC 1.5.0+

moment.utc();
moment.utc(Number);
moment.utc(Number[]);
moment.utc(String);
moment.utc(String, String);
moment.utc(String, String[]);
moment.utc(String, String, String);
moment.utc(Moment);
moment.utc(Date);

moment.utc()

moment()

moment().format();     // 2013-02-04T10:35:24-08:00
moment.utc().format(); // 2013-02-04T18:35:24+00:00

Date#getUTC*

Date#setUTC*

Date#get*

Date#set*

moment.utc().seconds(30) === new Date().setUTCSeconds(30);
moment.utc().seconds()   === new Date().getUTCSeconds();

var a = moment();
var b = moment.utc();
a.format();  // 2013-02-04T10:35:24-08:00
b.format();  // 2013-02-04T18:35:24+00:00
a.valueOf(); // 1360002924000
b.valueOf(); // 1360002924000

moment.utc()

moment()

var a = moment.utc([2011, 0, 1, 8]);
a.hours(); // 8 UTC
a.local();
a.hours(); // 0 PST

时区 2.3.0+

moment.parseZone(String)

moment.utc()

#parseZone

moment.parseZone("2013-01-01T00:00:00-13:00").zone(); // 780

moment.parseZone

moment#zone

var s = "2013-01-01T00:00:00-13:00";
moment(s).zone(s);

合法性校验 1.7.0+

moment().isValid();

Date

new Date(2013, 25, 14).toString(); // "Sat Feb 14 2015 00:00:00 GMT-0500 (EST)"
moment([2015, 25, 35]).format();   // 'Invalid date'

moment#isValid

#isValid

moment#parsingFlags

overflow

overflow

#invalidAt

-1

invalidMonth

moment('Marbruary', 'MMMM');

empty

moment('this
is nonsense');

nullInput

null

moment(null);

invalidFormat

moment('2013-05-25',
[])

userInvalidated

moment.invalid()

unusedTokens

unusedInput

moment#invalidAt

var m = moment("2011-10-10T10:20:90");
m.isValid(); // false
m.invalidAt(); // 5 for seconds

默认值 2.2.1+

moment("15", "hh")

moment();  // current date and time

moment(5, "HH");  // today, 5:00:00.000
moment({hour: 5});  // today, 5:00:00.000
moment({hour: 5, minute: 10});  // today, 5:10.00.000
moment({hour: 5, minute: 10, seconds: 20});  // today, 5:10.20.000
moment({hour: 5, minute: 10, seconds: 20, milliseconds: 300});  // today, 5:10.20.300

moment(5, "DD");  // this month, 5th day-of-month
moment("4 05:06:07", "DD hh:mm:ss");  // this month, 4th day-of-month, 05:06:07.000

moment(3, "MM");  // this year, 3th month (April)
moment("Apr 4 05:06:07", "MMM DD hh:mm:ss");  // this year, 5th April, 05:06:07.000

取值/赋值

Date

moment().seconds(30) === new Date().setSeconds(30);
moment().seconds()   === new Date().getSeconds();

moment.utc().seconds(30) === new Date().setUTCSeconds(30);
moment.utc().seconds()   === new Date().getUTCSeconds();

2.0.0

毫秒 1.3.0+

moment().millisecond(Number);
moment().millisecond(); // Number
moment().milliseconds(Number);
moment().milliseconds(); // Number

秒 1.0.0+

moment().second(Number);
moment().second(); // Number
moment().seconds(Number);
moment().seconds(); // Number

分钟 1.0.0+

moment().minute(Number);
moment().minute(); // Number
moment().minutes(Number);
moment().minutes(); // Number

小时 1.0.0+

moment().hour(Number);
moment().hour(); // Number
moment().hours(Number);
moment().hours(); // Number

日期 1.0.0+

moment().date(Number);
moment().date(); // Number
moment().dates(Number);
moment().dates(); // Number

Moment#date

Moment#day

星期 1.3.0+

moment().day(Number|String);
moment().day(); // Number
moment().days(Number|String);
moment().days(); // Number

moment().day(-7); // last Sunday (0 - 7)
moment().day(7); // next Sunday (0 + 7)
moment().day(10); // next Wednesday (3 + 7)
moment().day(24); // 3 Wednesdays from now (3 + 7 + 7 + 7)

Moment#date

Moment#day

moment().day("Sunday");
moment().day("Monday");

星期 (区域标准) 2.1.0+

moment().weekday(Number);
moment().weekday(); // Number

moment().weekday(0)

moment().weekday(0)

moment#day

// when Monday is the first day of the week
moment().weekday(-7); // last Monday
moment().weekday(7); // next Monday
// when Sunday is the first day of the week
moment().weekday(-7); // last Sunday
moment().weekday(7); // next Sunday

星期 (ISO) 2.1.0+

moment().isoWeekday(Number);
moment().isoWeekday(); // Number

1

7

moment().isoWeekday(1); // Monday
moment().isoWeekday(7); // Sunday

天 2.0.0+

moment().dayOfYear(Number);
moment().dayOfYear(); // Number

周 2.0.0+

moment().week(Number);
moment().week(); // Number
moment().weeks(Number);
moment().weeks(); // Number

moment#week

moment#week

周 (ISO) 2.0.0+

moment().isoWeek(Number);
moment().isoWeek(); // Number
moment().isoWeeks(Number);
moment().isoWeeks(); // Number

月 1.0.0+

moment().month(Number|String);
moment().month(); // Number
moment().months(Number|String);
moment().months(); // Number

moment().month("January");
moment().month("Feb");

// before 2.1.0
moment([2012, 0, 31]).month(1).format("YYYY-MM-DD"); // 2012-03-02
// after 2.1.0
moment([2012, 0, 31]).month(1).format("YYYY-MM-DD"); // 2012-02-29

季度 2.6.0+

moment().quarter(); // Number
moment().quarter(Number);

moment('2013-01-01T00:00:00.000').quarter() // 1
moment('2013-04-01T00:00:00.000').subtract(1, 'ms').quarter() // 1
moment('2013-04-01T00:00:00.000').quarter() // 2
moment('2013-07-01T00:00:00.000').subtract(1, 'ms').quarter() // 2
moment('2013-07-01T00:00:00.000').quarter() // 3
moment('2013-10-01T00:00:00.000').subtract(1, 'ms').quarter() // 3
moment('2013-10-01T00:00:00.000').quarter() // 4
moment('2014-01-01T00:00:00.000').subtract(1, 'ms').quarter() // 4

moment('2013-01-01T00:00:00.000').quarter(2) // '2013-04-01T00:00:00.000'
moment('2013-02-05T05:06:07.000').quarter(2).format() // '2013-05-05T05:06:07-07:00'

年 1.0.0+

moment().year(Number);
moment().year(); // Number
moment().years(Number);
moment().years(); // Number

周 (区域标准) 2.1.0+

moment().weekYear(Number);
moment().weekYear(); // Number

周 (ISO) 2.1.0+

moment().isoWeekYear(Number);
moment().isoWeekYear(); // Number

周数 2.6.0+

moment().weeksInYear();

周数 (ISO) 2.6.0+

moment().isoWeeksInYear();

取值 2.2.1+

moment().get('year');
moment().get('month');  // 0 to 11
moment().get('date');
moment().get('hour');
moment().get('minute');
moment().get('second');
moment().get('millisecond');

moment().get(unit) === moment()[unit]()

赋值 2.2.1+

moment().set(String, Int);
moment().set(Object(String, Int));

moment().set('year', 2013);
moment().set('month', 3);  // April
moment().set('date', 1);
moment().set('hour', 13);
moment().set('minute', 20);
moment().set('second', 30);
moment().set('millisecond', 123);

moment().set({'year': 2013, 'month': 3});

最大值 2.7.0+

moment.max(Moment[,Moment...]);

var a = moment().subtract(1, 'day');
var b = moment().add(1, 'day');
moment.max(a, b);  // b

2.10.5

moment.max(moment(), moment.invalid()).isValid() === false
moment.max(moment.invalid(), moment()).isValid() === false

最小值 2.7.0+

moment.min(Moment[,Moment...]);

var a = moment().subtract(1, 'day');
var b = moment().add(1, 'day');
moment.min(a, b);  // a

2.10.5

moment.min(moment(), moment.invalid()).isValid() === false
moment.min(moment.invalid(), moment()).isValid() === false

操作

Moment

moment().add(7, 'days').subtract(1, 'months').year(2009).hours(0).minutes(0).seconds(0);

moment#clone

加法 1.0.0+

moment().add(Number, String);
moment().add(Duration);
moment().add(Object);

moment().add(7, 'days');

moment().add(7, 'd');

moment().add(7, 'days').add(1, 'months'); // with chaining
moment().add({days:7,months:1}); // with object literal

moment().add(1000000, 'milliseconds'); // a million milliseconds
moment().add(360, 'days'); // 360 days

Special considerations for months and years

moment([2010, 0, 31]);                  // January 31
moment([2010, 0, 31]).add(1, 'months'); // February 28

var m = moment(new Date(2011, 2, 12, 5, 0, 0)); // the day before DST in the US
m.hours(); // 5
m.add(1, 'days').hours(); // 5

var m = moment(new Date(2011, 2, 12, 5, 0, 0)); // the day before DST in the US
m.hours(); // 5
m.add(24, 'hours').hours(); // 6

var duration = moment.duration({'days' : 1});
moment([2012, 0, 31]).add(duration); // February 1

2.8.0

moment#add(String,
Number)

moment#add(Number, String)

moment().add('seconds', 1); // Deprecated in 2.8.0
moment().add(1, 'seconds');

减法 1.0.0+

moment().subtract(Number, String);
moment().subtract(Duration);
moment().subtract(Object);

moment#add

moment().subtract(7, 'days');

2.8.0

moment#subtract(String,
Number)

moment#subtract(Number, String)

moment().subtract('seconds', 1); // Deprecated in 2.8.0
moment().subtract(1, 'seconds');

开始时间 1.7.0+

moment().startOf(String);

moment().startOf('year');    // set to January 1st, 12:00 am this year
moment().startOf('month');   // set to the first of this month, 12:00 am
moment().startOf('quarter');  // set to the beginning of the current quarter, 1st day of months, 12:00 am
moment().startOf('week');    // set to the first day of this week, 12:00 am
moment().startOf('isoWeek'); // set to the first day of this week according to ISO 8601, 12:00 am
moment().startOf('day');     // set to 12:00 am today
moment().startOf('hour');    // set to now, but with 0 mins, 0 secs, and 0 ms
moment().startOf('minute');  // set to now, but with 0 seconds and 0 milliseconds
moment().startOf('second');  // same as moment().milliseconds(0);

moment().startOf('year');
moment().month(0).date(1).hours(0).minutes(0).seconds(0).milliseconds(0);

moment().startOf('hour');
moment().minutes(0).seconds(0).milliseconds(0)

moment#startOf('day')

moment#sod

moment#startOf('week')

moment#startOf('week')

moment#startOf('isoWeek')

结束时间 1.7.0+

moment().endOf(String);

moment#startOf

moment().endOf("year"); // set the moment to 12-31 11:59:59.999 pm this year

moment#endOf('day')

moment#eod

moment#endOf('week')

moment#endOf('week')

最大值 From 2.1.0, Deprecated 2.7.0

moment().max(Moment|String|Number|Date|Array);

moment.min

a.max(b)

a
= moment.min(a, b)

max

min

moment#max()

moment#min

var momentFromServer = moment(input);
var clampedMoment = momentFromServer.max();

moment#max

moment()

moment().max(moment().add(1, 'd'));
moment().max("2013-04-20T20:00:00+0800");
moment().max("Jan 1 2001", "MMM D YYYY");
moment().max(new Date(2012, 1, 8));

最小值 From 2.1.0, Deprecated 2.7.0

moment().min(Moment|String|Number|Date|Array);

moment.max

a.min(b)

a
= moment.max(a, b)

min

max

moment#max

moment().min("2013-04-20T20:00:00+0800");

moment#max

var start  = moment().startOf('week');
var end    = moment().endOf('week');
var actual = moment().min(start).max(end);

本地化 1.5.0+

moment().local();

Date#get*

Date#set*

Date#getUTC*

Date#setUTC*

var a = moment.utc([2011, 0, 1, 8]);
a.hours(); // 8 UTC
a.local();
a.hours(); // 0 PST

UTC 1.5.0+

moment().utc();

Date#getUTC*

Date#setUTC*

Date#get*

Date#set*

var a = moment([2011, 0, 1, 8]);
a.hours(); // 8 PST
a.utc();
a.hours(); // 16 UTC

UTC 偏移量 2.9.0++

moment().utcOffset();
moment().utcOffset(Number|String);

moment.fn.zone

Date.prototype.getTimezoneOffset

moment().utcOffset(); // (-240, -120, -60, 0, 60, 120, 240, etc.)

America/Los_Angeles

moment().utcOffset(120);

16

-16

// these are equivalent
moment().utcOffset(8);  // set hours offset
moment().utcOffset(480);  // set minutes offset (8 * 60)

// these are equivalent
moment().utcOffset("+08:00");
moment().utcOffset(8);
moment().utcOffset(480);

moment#utcOffset

+00:00
+0000 -00:00 -0000

+

-

+

-

"+00:00"

moment().utcOffset("2013-03-07T07:00:00+08:00");

时区偏移量 From 1.2.0, deprecated 2.9.0+

moment().zone();
moment().zone(Number|String);

moment.fn.utcOffset

moment().zone(); // (60, 120, 240, etc.)

moment().zone(120);

16

-16

// these are equivalent
moment().zone(480);
moment().zone(8);

moment().zone("-08:00");

moment#zone

+00:00
+0000 -00:00 -0000

moment().zone("2013-03-07T07:00:00-08:00");

显示

格式化 1.0.0+

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"

Z ZZ

S SS SSS

X

e E gg gggg GG GGGG

x

SSSS

SSSSSSSSS

Localized formats

L LL LLL LLLL LT

l
ll lll llll

LTS

Escaping characters

moment().format('[today] dddd'); // 'today Sunday'

Similarities and differences with LDML

Formatting speed

Other tokens

Default format

moment#format

moment.defaultFormat

moment.defaultFormat

YYYY-MM-DDTHH:mm:ssZ

时差 (之前，现在为基准) 1.0.0+

moment().fromNow();
moment().fromNow(Boolean);

moment#fromNow

moment([2007, 0, 29]).fromNow(); // 4 years ago

true

moment([2007, 0, 29]).fromNow();     // 4 years ago
moment([2007, 0, 29]).fromNow(true); // 4 years

时差 (之前) 1.0.0+

moment().from(Moment|String|Number|Date|Array);
moment().from(Moment|String|Number|Date|Array, Boolean);

moment#from

var a = moment([2007, 0, 28]);
var b = moment([2007, 0, 29]);
a.from(b) // "a day ago"

moment()

Moment

var a = moment([2007, 0, 28]);
var b = moment([2007, 0, 29]);
a.from(b);                     // "a day ago"
a.from([2007, 0, 29]);         // "a day ago"
a.from(new Date(2007, 0, 29)); // "a day ago"
a.from("2007-01-29");          // "a day ago"

moment#fromNow

true

var start = moment([2007, 0, 5]);
var end   = moment([2007, 0, 10]);
end.from(start);       // "in 5 days"
end.from(start, true); // "5 days"

时差 (之后，现在为基准) 2.10.3+

moment().toNow();
moment().toNow(Boolean);

moment#toNow

moment.fromNow

a.fromNow() = - a.toNow()

moment.to

moment.to

moment([2007, 0, 29]).toNow(); // in 4 years

true

moment([2007, 0, 29]).toNow();     // in 4 years
moment([2007, 0, 29]).toNow(true); // 4 years

时差 (之后) 2.10.3+

moment().to(Moment|String|Number|Date|Array);
moment().to(Moment|String|Number|Date|Array, Boolean);

moment#to

var a = moment([2007, 0, 28]);
var b = moment([2007, 0, 29]);
a.to(b) // "in a day"

moment()

Moment

var a = moment([2007, 0, 28]);
var b = moment([2007, 0, 29]);
a.to(b);                     // "in a day"
a.to([2007, 0, 29]);         // "in a day"
a.to(new Date(2007, 0, 29)); // "in a day"
a.to("2007-01-29");          // "in a day"

moment#toNow

true

var start = moment([2007, 0, 5]);
var end   = moment([2007, 0, 10]);
end.to(start);       // "5 days ago"
end.to(start, true); // "5 days"

日历时间 1.3.0+

moment().calendar();
moment().calendar(referenceTime);
moment().calendar(referenceTime, formats);  // from 2.10.5

referenceTime

moment#fromNow

moment#calendar

referenceTime

moment().calendar(null, {
sameDay: '[Today]',
nextDay: '[Tomorrow]',
nextWeek: 'dddd',
lastDay: '[Yesterday]',
lastWeek: '[Last] dddd',
sameElse: 'DD/MM/YYYY'
});

sameElse

referenceTime

时差 (毫秒) 1.0.0+

moment().diff(Moment|String|Number|Date|Array);
moment().diff(Moment|String|Number|Date|Array, String);
moment().diff(Moment|String|Number|Date|Array, String, Boolean);

moment#diff

moment#from

var a = moment([2007, 0, 29]);
var b = moment([2007, 0, 28]);
a.diff(b) // 86400000

var a = moment([2007, 0, 29]);
var b = moment([2007, 0, 28]);
a.diff(b, 'days') // 1

moment#diff

true

moment#diff

var a = moment([2008, 6]);
var b = moment([2007, 0]);
a.diff(b, 'years');       // 1
a.diff(b, 'years', true); // 1.5

moment.fn.diff

var a = moment();
var b = moment().add(1, 'seconds');
a.diff(b) // -1000
b.diff(a) // 1000

.diff(

// a < b
a.diff(b) // a - b < 0
b.diff(a) // b - a > 0

Month and year diffs

moment#diff

Unix 偏移量 (毫秒) 1.0.0+

moment().valueOf();
+moment();

moment#valueOf

Date#valueOf

moment(1318874398806).valueOf(); // 1318874398806
+moment(1318874398806); // 1318874398806

Moment

moment#unix

Unix 时间戳 (秒) 1.6.0+

moment().unix();

moment#unix

moment(1318874398806).unix(); // 1318874398

天数 (月) 1.5.0+

moment().daysInMonth();

moment("2012-02", "YYYY-MM").daysInMonth() // 29
moment("2012-01", "YYYY-MM").daysInMonth() // 31

Date 对象 1.0.0+

moment().toDate();

moment#toDate

Date

Date

Date

moment#clone

moment#toDate

moment#native

moment#toDate

数组 1.7.0+

moment().toArray();

new Date()

moment().toArray(); // [2013, 1, 4, 14, 40, 16, 154];

JSON 2.0.0+

moment().toJSON();

Moment

JSON.stringify({
postDate : moment()
}); // '{"postDate":"2013-02-04T22:44:30.652Z"}'

utcOffset()

toJSON

moment.fn.toJSON = function() { return this.format(); }

JSON.stringify({
postDate : moment()
}); // '{"postDate":"2013-02-04T14:44:30-08:00"}'

ISO 8601 字符串 2.1.0+

moment().toISOString();

moment().toISOString() // 2013-02-04T22:44:30.652Z

Date.prototype.toISOString

对象 2.10.5+

moment().toObject();

moment().toObject()  // {
//     years: 2015
//     months: 6
//     date: 26,
//     hours: 1,
//     minutes: 53,
//     seconds: 14,
//     milliseconds: 600
// }

查询

是否之前 2.0.0+

moment().isBefore(Moment|String|Number|Date|Array);
moment().isBefore(Moment|String|Number|Date|Array, String);

moment('2010-10-20').isBefore('2010-10-21'); // true

moment('2010-10-20').isBefore('2010-12-31', 'year'); // false
moment('2010-10-20').isBefore('2011-01-01', 'year'); // true

moment#isAfter

moment#isSame

moment#startOf

moment#isBefore

year month week day hour minute second

moment#isBefore

moment().isBefore()

false

moment()

true

是否相同 2.0.0+

moment().isSame(Moment|String|Number|Date|Array);
moment().isSame(Moment|String|Number|Date|Array, String);

moment('2010-10-20').isSame('2010-10-20'); // true

moment('2010-10-20').isSame('2009-12-31', 'year');  // false
moment('2010-10-20').isSame('2010-01-01', 'year');  // true
moment('2010-10-20').isSame('2010-12-31', 'year');  // true
moment('2010-10-20').isSame('2011-01-01', 'year');  // false

month

month

year

day

day

month

year

moment('2010-01-01').isSame('2011-01-01', 'month'); // false, different year
moment('2010-01-01').isSame('2010-02-01', 'day');   // false, different month

moment#isAfter

moment#isBefore

moment#startOf

moment#isSame

year month week day hour minute second

是否之后 2.0.0+

moment().isAfter(Moment|String|Number|Date|Array);
moment().isAfter(Moment|String|Number|Date|Array, String);

moment('2010-10-20').isAfter('2010-10-19'); // true

moment('2010-10-20').isAfter('2010-01-01', 'year'); // false
moment('2010-10-20').isAfter('2009-12-31', 'year'); // true

moment#isSame

moment#isBefore

moment#startOf

moment#isAfter

year month week day hour minute second

moment#isAfter

moment().isAfter(); // false

是否之间 2.9.0+

moment().isBetween(moment-like, moment-like);
moment().isBetween(moment-like, moment-like, String);
// where moment-like is Moment|String|Number|Date|Array

moment('2010-10-20').isBetween('2010-10-19', '2010-10-25'); // true

moment('2010-10-20').isBetween('2010-01-01', '2012-01-01', 'year'); // false
moment('2010-10-20').isBetween('2009-12-31', '2012-01-01', 'year'); // true

moment#isSame

moment#isBefore

moment#isAfter

moment#startOf

moment#isBetween

是否闰年 1.0.0+

moment().isLeapYear();

moment#isLeapYear

true

false

moment([2000]).isLeapYear() // true
moment([2001]).isLeapYear() // false
moment([2100]).isLeapYear() // false

是否夏令时 1.2.0+

moment().isDST();

moment#isDST

moment([2011, 2, 12]).isDST(); // false, March 12 2011 is not DST
moment([2011, 2, 14]).isDST(); // true, March 14 2011 is DST

是否被夏令时转换 2.3.0+

moment('2013-03-10 2:30', 'YYYY-MM-DD HH:mm').isDSTShifted()

moment('2013-03-10 2:30', 'YYYY-MM-DD HH:mm').format(); //=> '2013-03-10T01:30:00-05:00'

moment#isDSTShifted

false

moment#isValid

true

是否 Moment 对象 1.5.0+

moment.isMoment(obj);

moment.isMoment()

moment.isMoment() // false
moment.isMoment(new Date()) // false
moment.isMoment(moment()) // true

是否 Date 对象 2.9.0+

moment.isDate(obj);

moment.isDate()

moment.isDate(); // false
moment.isDate(new Date()); // true
moment.isDate(moment()); // false

国际化

设置语言 (全局) 1.0.0+

// From 2.8.1 onward
moment.locale(String);
moment.locale(String[]);
moment.locale(String, Object);

// Deprecated in 2.8.1
moment.lang(String);
moment.lang(String[]);
moment.lang(String, Object);

moment.locale

moment.locale('fr', {
months : "janvier_février_mars_avril_mai_juin_juillet_août_septembre_octobre_novembre_décembre".split("_"),
monthsShort : "janv._févr._mars_avr._mai_juin_juil._août_sept._oct._nov._déc.".split("_"),
weekdays : "dimanche_lundi_mardi_mercredi_jeudi_vendredi_samedi".split("_"),
weekdaysShort : "dim._lun._mar._mer._jeu._ven._sam.".split("_"),
weekdaysMin : "Di_Lu_Ma_Me_Je_Ve_Sa".split("_"),
longDateFormat : {
LT : "HH:mm",
LTS : "HH:mm:ss",
L : "DD/MM/YYYY",
LL : "D MMMM YYYY",
LLL : "D MMMM YYYY LT",
LLLL : "dddd D MMMM YYYY LT"
},
calendar : {
sameDay: "[Aujourd'hui à] LT",
nextDay: '[Demain à] LT',
nextWeek: 'dddd [à] LT',
lastDay: '[Hier à] LT',
lastWeek: 'dddd [dernier à] LT',
sameElse: 'L'
},
relativeTime : {
future : "dans %s",
past : "il y a %s",
s : "quelques secondes",
m : "une minute",
mm : "%d minutes",
h : "une heure",
hh : "%d heures",
d : "un jour",
dd : "%d jours",
M : "un mois",
MM : "%d mois",
y : "une année",
yy : "%d années"
},
ordinalParse : /\d{1,2}(er|ème)/,
ordinal : function (number) {
return number + (number === 1 ? 'er' : 'ème');
},
meridiemParse: /PD|MD/,
isPM: function (input) {
return input.charAt(0) === 'M';
},
// in case the meridiem units are not separated around 12, then implement
// this function (look at locale/id.js for an example)
// meridiemHour : function (hour, meridiem) {
//     return /* 0-23 hour, given meridiem token and hour 1-12 */
// },
meridiem : function (hours, minutes, isLower) {
return hours < 12 ? 'PD' : 'MD';
},
week : {
dow : 1, // Monday is the first day of the week.
doy : 4  // The week that contains Jan 4th is the first week of the year.
}
});

moment.locale

moment.locale('fr');
moment(1316116057189).fromNow() // il y a une heure
moment.locale('en');
moment(1316116057189).fromNow() // an hour ago

moment.locale('fr');
var m = moment(1316116057189);
m.fromNow(); // il y a une heure

moment.locale('en');
m.fromNow(); // il y a une heure
moment(1316116057189).fromNow(); // an hour ago

moment.locale

moment.locale('fr'); // 'fr'
moment.locale('tq'); // 'fr'

moment.locale(['tq', 'fr']); // 'fr'

window.navigator.language

moment.locale('en-NZ'); // 'en'

moment.locale('en-NZ', 'en-AU'); // 'en-au', not 'en'

设置语言 (局部) 1.7.0+

// From version 2.8.1 onward
moment().locale(String);

// Deprecated version 2.8.1
moment().lang(String);

moment.locale('en'); // default the locale to English
var localLocale = moment();

localLocale.locale('fr'); // set this instance to use French
localLocale.format('LLLL'); // dimanche 15 juillet 2012 11:01
moment().format('LLLL'); // Sunday, July 15 2012 11:01 AM

moment.locale('es'); // change the global locale to Spanish
localLocale.format('LLLL'); // dimanche 15 juillet 2012 11:01
moment().format('LLLL'); // Domingo 15 Julio 2012 11:01

localLocale.locale(false); // reset the instance locale
localLocale.format('LLLL'); // Domingo 15 Julio 2012 11:01
moment().format('LLLL'); // Domingo 15 Julio 2012 11:01

moment#locale

var fr = moment().locale('fr');
fr.localeData().months(moment([2012, 0])) // "janvier"
fr.locale('en');
fr.localeData().months(moment([2012, 0])) // "January"

加载语言 (NodeJS) 1.0.0+

moment.locale(String);

moment-root/locale/

moment.locale

var moment = require('moment');
moment.locale('fr');
moment(1316116057189).fromNow(); // il y a une heure

develop

加载语言 (浏览器) 1.0.0+

// From 2.8.1 onward
moment.locale(String, Object);

// Deprecated in 2.8.1
moment.lang(String, Object);

<script src="moment.js"></script>
<script src="locale/fr.js"></script>
<script src="locale/pt.js"></script>
<script>
moment.locale('fr');  // Set the default/global locale
// ...
</script>

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

grunt transpile:fr,it

<script src="min/moment-with-locales.custom.js"></script>

新增语言

moment/locale/fr.js

moment/test/locale/fr.js

npm install

grunt

获取当前语言 1.6.0+

// From version 2.8.1 onward
moment.locale();

// Deprecated in version 2.8.1
moment.lang();

moment.locale

moment.locale('en'); // set to english
moment.locale(); // returns 'en'
moment.locale('fr'); // set to french
moment.locale(); // returns 'fr'

列出月份和星期 2.3.0+

moment.months()
moment.monthsShort()
moment.weekdays()
moment.weekdaysShort()
moment.weekdaysMin()

moment.months();

[ 'January',
'February',
'March',
'April',
'May',
'June',
'July',
'August',
'September',
'October',
'November',
'December' ]

moment.monthsShort

moment.weekdays

moment.weekdaysShort

moment.weekdaysMin

moment.weekdays(3); // 'Wednesday'

months

moment.locale('nl');
moment.monthsShort(); // ['jan.', 'feb.', 'mrt.', ...]
moment.monthsShort('-MMM-'); // [ 'jan', 'feb', 'mrt', ...]

moment.monthsShort('-MMM-', 3); // 'apr'

获取语言数据 2.8.0+

localeData = moment.localeData()
localeData.months()
localeData.monthsShort()
localeData.monthsParse()
localeData.weekdays()
localeData.weekdaysShort()
localeData.weekdaysMin()
localeData.weekdaysParse()
localeData.longDateFormat()
localeData.isPM()
localeData.meridiem()
localeData.calendar()
localeData.relativeTime()
localeData.pastFuture()
localeData.ordinal()
localeData.preparse()
localeData.postformat()
localeData.weeks()
localeData.invalidDate()
localeData.firstDayOfWeek()
localeData.firstDayOfYear()

moment.localeData(key)

// get current locale
var currentLocaleData = moment.localeData();
var frLocaleData = moment.localeData('fr');

localeData.months(aMoment);  // full month name of aMoment
localeData.monthsShort(aMoment);  // short month name of aMoment
localeData.monthsParse(longOrShortMonthString);  // returns month id (0 to 11) of input
localeData.weekdays(aMoment);  // full weekday name of aMoment
localeData.weekdaysShort(aMoment);  // short weekday name of aMoment
localeData.weekdaysMin(aMoment);  // min weekday name of aMoment
localeData.weekdaysParse(minShortOrLongWeekdayString);  // returns weekday id (0 to 6) of input
localeData.longDateFormat(dateFormat);  // returns the full format of abbreviated date-time formats LT, L, LL and so on
localeData.isPM(amPmString);  // returns true iff amPmString represents PM
localeData.meridiem(hours, minutes, isLower);  // returns am/pm string for particular time-of-day in upper/lower case
localeData.calendar(key, aMoment);  // returns a format that would be used for calendar representation. Key is one of 'sameDay', 'nextDay', 'lastDay', 'nextWeek', 'prevWeek', 'sameElse'
localeData.relativeTime(number, withoutSuffix, key, isFuture);  // returns relative time string, key is on of 's', 'm', 'mm', 'h', 'hh', 'd', 'dd', 'M', 'MM', 'y', 'yy'. Single letter when number is 1.
localeData.pastFuture(diff, relTime);  // convert relTime string to past or future string depending on diff
localeData.ordinal(number);  // convert number to ordinal string 1 -> 1st
localeData.preparse(str);  // called before parsing on every input string
localeData.postformat(str);  // called after formatting on every string
localeData.week(aMoment);  // returns week-of-year of aMoment
localeData.invalidDate();  // returns a translation of 'Invalid date'
localeData.firstDayOfWeek();  // 0-6 (Sunday to Saturday)
localeData.firstDayOfYear();  // 0-15 this and the first day of week are used
// to determine which is the first week of the
// year. dow == 1 and doy == 4 means week starts
// Monday and first week that has Thursday is the
// first week of the year (but doy is NOT simply
// Thursday).

自定义

moment.locale('en-my-settings', {
// customizations.
});

moment.locale('en', {
// customizations
});

null

moment.locale('fr'); // 'fr'
moment.locale('en'); // 'en'
moment.locale('fr', null);
moment.locale('fr'); // 'en'

月份名 1.0.0+

// From 2.8.1 onward
moment.locale('en', {
months : String[]
});
moment.locale('en', {
months : Function
});

// Deprecated in 2.8.1
moment.lang('en', {
months : String[]
});
moment.lang('en', {
months : Function
});

Locale#months

moment.locale('en', {
months : [
"January", "February", "March", "April", "May", "June", "July",
"August", "September", "October", "November", "December"
]
});

Locale#months

moment.locale('en', {
months : function (momentToFormat, format) {
// momentToFormat is the moment currently being formatted
// format is the formatting string
if (/^MMMM/.test(format)) { // if the format starts with 'MMMM'
return nominative[momentToFormat.month()];
} else {
return subjective[momentToFormat.month()];
}
}
});

月份名 (缩写) 1.0.0+

// From 2.8.1 onward
moment.locale('en', {
monthsShort : String[]
});
moment.locale('en', {
monthsShort : Function
});

// Deprecated in 2.8.1
moment.lang('en', {
monthsShort : String[]
});
moment.lang('en', {
monthsShort : Function
});

Locale#monthsShort

moment.locale('en', {
monthsShort : [
"Jan", "Feb", "Mar", "Apr", "May", "Jun",
"Jul", "Aug", "Sep", "Oct", "Nov", "Dec"
]
});

Locale#months

Locale#monthsShort

moment.locale('en', {
monthsShort : function (momentToFormat, format) {
if (/^MMMM/.test(format)) {
return nominative[momentToFormat.month()];
} else {
return subjective[momentToFormat.month()];
}
}
});

星期名 1.0.0+

// From version 2.8.1 onward
moment.locale('en', {
weekdays : String[]
});
moment.locale('en', {
weekdays : Function
});

// Deprecated version 2.8.1
moment.lang('en', {
weekdays : String[]
});
moment.lang('en', {
weekdays : Function
});

Locale#weekdays

moment.locale('en', {
weekdays : [
"Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"
]
});

Locale#weekdays

moment.locale('en', {
weekdays : function (momentToFormat, format) {
return weekdays[momentToFormat.day()];
}
});

星期名 (缩写) 1.0.0+

// From 2.8.1 onward
moment.locale('en', {
weekdaysShort : String[]
});
moment.locale('en', {
weekdaysShort : Function
});

// Deprecated in 2.8.1
moment.lang('en', {
weekdaysShort : String[]
});
moment.lang('en', {
weekdaysShort : Function
});

Locale#weekdaysShort

moment.locale('en', {
weekdaysShort : ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"]
});

Locale#weekdaysShort

moment.locale('en', {
weekdaysShort : function (momentToFormat, format) {
return weekdaysShort[momentToFormat.day()];
}
});

星期名 (极简缩写) 1.7.0+

// From 2.8.1 onward
moment.locale('en', {
weekdaysMin : String[]
});
moment.locale('en', {
weekdaysMin : Function
});

// Deprecated in 2.8.1
moment.lang('en', {
weekdaysMin : String[]
});
moment.lang('en', {
weekdaysMin : Function
});

Locale#weekdaysMin

moment.locale('en', {
weekdaysMin : ["Su", "Mo", "Tu", "We", "Th", "Fr", "Sa"]
});

Locale#weekdaysMin

moment.locale('en', {
weekdaysMin : function (momentToFormat, format) {
return weekdaysMin[momentToFormat.day()];
}
});

长日期格式 1.1.0+

// From 2.8.1 onward
moment.locale('en', {
longDateFormat : Object
});

// Deprecated in 2.8.1
moment.lang('en', {
longDateFormat : Object
});

Locale#longDateFormat

L
LL LLL LLLL LT LTS

LT

moment#calendar

moment.locale('en', {
longDateFormat : {
LT: "h:mm A",
LTS: "h:mm:ss A",
L: "MM/DD/YYYY",
l: "M/D/YYYY",
LL: "MMMM Do YYYY",
ll: "MMM D YYYY",
LLL: "MMMM Do YYYY LT",
lll: "MMM D YYYY LT",
LLLL: "dddd, MMMM Do YYYY LT",
llll: "ddd, MMM D YYYY LT"
}
});

l

moment.locale('en', {
longDateFormat : {
LT: "h:mm A",
LTS: "h:mm:ss A",
L: "MM/DD/YYYY",
LL: "MMMM Do YYYY",
LLL: "MMMM Do YYYY LT",
LLLL: "dddd, MMMM Do YYYY LT"
}
});

相对时间 1.0.0+

// From 2.8.1 onward
moment.locale('en', {
relativeTime : Object
});

// Deprecated in 2.8.1
moment.lang('en', {
relativeTime : Object
});

Locale#relativeTime

moment#from

moment.locale('en', {
relativeTime : {
future: "in %s",
past:   "%s ago",
s:  "seconds",
m:  "a minute",
mm: "%d minutes",
h:  "an hour",
hh: "%d hours",
d:  "a day",
dd: "%d days",
M:  "a month",
MM: "%d months",
y:  "a year",
yy: "%d years"
}
});

Locale#relativeTime.future

Locale#relativeTime.past

function (number, withoutSuffix, key, isFuture) {
return string;
}

key

Locale#relativeTime

s m mm h

number

m

withoutSuffix

isFuture

isFuture

上午/下午 1.6.0+

// From 2.8.1 onward
moment.locale('en', {
meridiem : Function
});

// Deprecated in 2.8.1
moment.lang('en', {
meridiem : Function
});

Locale#meridiem

Locale#meridiem

moment.locale('zh-cn', {
meridiem : function (hour, minute, isLowercase) {
if (hour < 9) {
return "早上";
} else if (hour < 11 && minute < 30) {
return "上午";
} else if (hour < 13 && minute < 30) {
return "中午";
} else if (hour < 18) {
return "下午";
} else {
return "晚上";
}
}
});

Locale#meridiem

moment.locale('en', {
meridiem : {
am : 'am',
AM : 'AM',
pm : 'pm',
PM : 'PM'
}
});

上午/下午 (解析) 2.1.0+

// From 2.8.1 onward
moment.locale('en', {
meridiemParse : RegExp
isPM : Function
});

// Deprecated in 2.8.1
moment.lang('en', {
meridiemParse : RegExp
isPM : Function
});

Locale#isPM

a
A

moment.locale('en', {
isPM : function (input) {
return ((input + '').toLowerCase()[0] === 'p');
}
});

meridiemParse

moment.locale('en', {
meridiemParse : /[ap]\.?m?\.?/i
});

日历 1.3.0+

// From 2.8.1 onward
moment.locale('en', {
calendar : Object
});

// Deprecated in 2.8.1
moment.lang('en', {
calendar : Object
});

Locale#calendar

moment.locale('en', {
calendar : {
lastDay : '[Yesterday at] LT',
sameDay : '[Today at] LT',
nextDay : '[Tomorrow at] LT',
lastWeek : '[last] dddd [at] LT',
nextWeek : 'dddd [at] LT',
sameElse : 'L'
}
});

Locale#calendar

function () {
return '[hoy a la' + ((this.hours() !== 1) ? 's' : '') + '] LT';
},

比较 1.0.0+

// From 2.8.1 onward
moment.locale('en', {
ordinal : Function
});

// Deprecated in 2.8.1
moment.lang('en', {
ordinal : Function
});

Locale#ordinal

moment.locale('en', {
ordinal : function (number, token) {
var b = number % 10;
var output = (~~ (number % 100 / 10) === 1) ? 'th' :
(b === 1) ? 'st' :
(b === 2) ? 'nd' :
(b === 3) ? 'rd' : 'th';
return number + output;
}
});

M

d

相对时间临界值 2.7.0+

moment.relativeTimeThreshold(unit);  // getter
moment.relativeTimeThreshold(unit, limit);  // setter

duration.humanize

moment.relativeTimeThreshold(unit, limit)

s

m

h

d

M

// Retrieve existing thresholds
moment.relativeTimeThreshold('s');  // 45
moment.relativeTimeThreshold('m');  // 45
moment.relativeTimeThreshold('h');  // 22
moment.relativeTimeThreshold('d');  // 26
moment.relativeTimeThreshold('M');  // 11

// Set new thresholds
moment.relativeTimeThreshold('s', 40);
moment.relativeTimeThreshold('m', 40);
moment.relativeTimeThreshold('h', 20);
moment.relativeTimeThreshold('d', 25);
moment.relativeTimeThreshold('M', 10);

时间段

moment#diff

Durations

创建 1.6.0+

moment.duration(Number, String);
moment.duration(Number);
moment.duration(Object);
moment.duration(String);

moment.duration()

moment.duration(100); // 100 milliseconds

moment.duration(2, 'seconds');
moment.duration(2, 'minutes');
moment.duration(2, 'hours');
moment.duration(2, 'days');
moment.duration(2, 'weeks');
moment.duration(2, 'months');
moment.duration(2, 'years');

moment#add

moment#subtract

moment#add

moment.duration({
seconds: 2,
minutes: 2,
hours: 2,
days: 2,
weeks: 2,
months: 2,
years: 2
});

23:59:59

7.23:59:59

23:59:59.999

moment.duration('23:59:59');
moment.duration('23:59:59.999');
moment.duration('7.23:59:59.999');
moment.duration('23:59');          //added in 2.3.0

moment.duration('P1Y2M3DT4H5M6S');
moment.duration('P1M');

拟人化 1.6.0+

moment.duration().humanize();

moment#from

moment.duration().humanize()

moment.duration(1, "minutes").humanize(); // a minute
moment.duration(2, "minutes").humanize(); // 2 minutes
moment.duration(24, "hours").humanize();  // a day

moment.duration(1, "minutes").humanize(true); // in a minute

moment.duration(-1, "minutes").humanize(true); // a minute ago

毫秒 1.6.0+

moment.duration().milliseconds();
moment.duration().asMilliseconds();

moment.duration().milliseconds()

moment.duration(500).milliseconds(); // 500
moment.duration(1500).milliseconds(); // 500
moment.duration(15000).milliseconds(); // 0

moment.duration().asMilliseconds()

moment.duration(500).asMilliseconds(); // 500
moment.duration(1500).asMilliseconds(); // 1500
moment.duration(15000).asMilliseconds(); // 15000

秒 1.6.0+

moment.duration().seconds();
moment.duration().asSeconds();

moment.duration().seconds()

moment.duration(500).seconds(); // 0
moment.duration(1500).seconds(); // 1
moment.duration(15000).seconds(); // 15

moment.duration().asSeconds()

moment.duration(500).asSeconds(); // 0.5
moment.duration(1500).asSeconds(); // 1.5
moment.duration(15000).asSeconds(); // 15

分钟 1.6.0+

moment.duration().minutes();
moment.duration().asMinutes();

moment.duration().minutes()

moment.duration().asMinutes()

小时 1.6.0+

moment.duration().hours();
moment.duration().asHours();

moment.duration().hours()

moment.duration().asHours()

天 1.6.0+

moment.duration().days();
moment.duration().asDays();

moment.duration().days()

moment.duration().asDays()

月 1.6.0+

moment.duration().months();
moment.duration().asMonths();

moment.duration().months()

moment.duration().asMonths()

年 1.6.0+

moment.duration().years();
moment.duration().asYears();

moment.duration().years()

moment.duration().asYears()

加法 2.1.0+

moment.duration().add(Number, String);
moment.duration().add(Number);
moment.duration().add(Duration);
moment.duration().add(Object);

var a = moment.duration(1, 'd');
var b = moment.duration(2, 'd');
a.add(b).days(); // 3

减法 2.1.0+

moment.duration().subtract(Number, String);
moment.duration().subtract(Number);
moment.duration().subtract(Duration);
moment.duration().subtract(Object);

var a = moment.duration(3, 'd');
var b = moment.duration(2, 'd');
a.subtract(b).days(); // 1

转换单位 2.1.0+

moment.duration().as(String);

Duration#asX

Duration#as('x')

moment#add

duration.as('hours');
duration.as('minutes');
duration.as('seconds');
duration.as('milliseconds');

取值 2.1.0+

moment.duration().get(String);

Duration#x()

Duration#get('x')

moment#add

duration.get('hours');
duration.get('minutes');
duration.get('seconds');
duration.get('milliseconds');

输出 JSON 2.9.0+

moment.duration().toJSON();

JSON.stringify({
postDuration : moment.duration(5, 'm')
}); // '{"postDuration":"PT5M"}'

Is a Duration 1.6.0+

moment.isDuration(obj);

moment.isDuration()

moment.isDuration() // false
moment.isDuration(new Date()) // false
moment.isDuration(moment()) // false
moment.isDuration(moment.duration()) // true
moment.isDuration(moment.duration(2, 'minutes')) // true

工具类函数

标准化单位 2.3.0+

moment.normalizeUnits(String);

get

var m = moment();
m.get('y');
m.get('year');
m.get('years');

moment.normalizeUnits('y');      // 'year'
moment.normalizeUnits('Y');      // 'year'
moment.normalizeUnits('year');   // 'year'
moment.normalizeUnits('years');  // 'year'
moment.normalizeUnits('YeARS');  // 'year'

无效对象 2.3.0+

moment.invalid(Object);

var m = moment.invalid();
m.isValid();                      // false
m.format();                       // 'Invalid date'
m.parsingFlags().userInvalidated; // true

invalid

userInvalidated

var m = moment.invalid({invalidMonth: 'Actober'});
m.parsingFlags().invalidMonth; // 'Actober'

parsingFlags()

插件

Strftime

npm install moment-strftime

moment-strftime

ISO Calendar

npm install moment-isocalendar

moment-isocalendar

[year, week_of_year, day_of_week, minutes_since_midnight]

moment().isocalendar(); // [2012, 8, 5, 870]

moment.fromIsocalendar([2011, 51, 5, 870]).format('LLLL');
// "Friday, December 23 2011 2:30 PM"

Date Ranges

npm install moment-range

moment-range

Twix

npm install twix

Twix

var t = moment("1/25/1982 9:30 AM").twix("1/25/1982 1:30 PM");
t.isCurrent(); // false
t.count('minutes'); // 241
t.format();  // 'Jan 25, 1982, 9:30 AM - 1:30 PM'
t.simpleFormat("h:m"); // '9:30 - 1:30'

npm install twix

Twitter

moment().subtract(5, 'hours').twitterLong();
// 5 hours

moment().subtract(1, 'hour').twitterLong();
// 1 hour

moment().subtract(6, 'days').twitterShort();
// 6d

Jalaali Calendar

npm install moment-jalaali

moment-jalaali

moment

var m = moment('1360/5/26', 'jYYYY/jM/jD'); // Parse a Jalaali date.
m.format('jYYYY/jM/jD [is] YYYY/M/D'); // 1360/5/26 is 1981/8/17

MSDate

moment-msdate

moment

moment().toOADate(); // a floating point number

moment

moment.fromOADate(41493); // Wed Aug 07 2013 00:00:00 GMT-0600 (MDT)

Fiscal Quarters

moment("2013-01-01").fquarter();
// Q4 2012/13

moment("2013-01-01").fquarter(7);
// Q3 2012/13

moment("2013-01-01").fquarter(1);
// Q1 2013

Precise Range

moment("2014-01-01 12:00:00").preciseDiff("2015-03-04 16:05:06");
// 1 year 2 months 3 days 4 hours 5 minutes 6 seconds

moment.preciseDiff("2014-01-01 12:00:00", "2014-04-20 12:00:00");
// 3 months 19 days

Recur

npm install moment-recur

moment-recur

matches

var interval = moment( "01/01/2014" ).recur().every(2).days(); // Length Interval
interval.matches( "01/03/2014" ); // true
interval.next( 2, "L" ); // ["01/03/2014", "01/05/2014"]
interval.forget( "days" ); // Remove a rule
interval.dayOfMonth( 10 ); // Calendar Interval
interval.matches( "05/10/2014" ); // true
interval.previous( 2, "L" ); // ["12/10/2013", "11/10/2013"]

Parse Date Format

npm install moment-parseformat

var format = moment.parseFormat('Thursday, February 6th, 2014 9:20pm');
// dddd, MMMM Do, YYYY h:mma
moment().format(format); // format

Java DateFormat Parser

npm install moment-jdateformatparser

java.text.DateFormat

moment("2013-12-24 14:30").formatWithJDF("dd.MM.yyyy");  // returns the formatted date "24.12.2013"
moment().toJDFString("DD.MM.YYYY");  // returns the Java format pattern "dd.MM.yyyy"

Hijri Calendar

npm install moment-hijri

moment-hijri

moment-hijri

moment

m = moment('1410/8/28', 'iYYYY/iM/iD'); // Parse a Hijri date.
m.format('iYYYY/iM/iD [is] YYYY/M/D'); // 1410/8/28 is 1990/3/25

Transform

bower install moment-transform

moment-transform

moment().transform('YYYY-MM-+01 00:00:00.000'); // Tonight at midnight
moment().transform('14:30:00.000'); // Today, 2:30 pm
moment().transform('YYYY-MM--30 00:00:00.000'); // 30 days ago

moment().transform('+01MMYYYY', 'DD/MM/YYYY', false); // Tomorrow, same time
moment().transform('+01MMYYYY', 'DD/MM/YYYY', true); // Invalid date