2015-11-24 22:08:25 -08:00
[](https://gitter.im/moment/moment?utm_source=badge& utm_medium=badge& utm_campaign=pr-badge& utm_content=badge)
2014-09-14 07:04:16 -04:00
2015-11-24 22:08:25 -08:00
[![NPM version][npm-version-image]][npm-url] [![NPM downloads][npm-downloads-image]][npm-url] [![MIT License][license-image]][license-url] [![Build Status][travis-image]][travis-url]
[](https://coveralls.io/r/moment/moment?branch=master)
2014-09-14 07:04:16 -04:00
2015-11-24 22:08:25 -08:00
A lightweight JavaScript date library for parsing, validating, manipulating, and formatting dates.
2014-09-14 07:04:16 -04:00
2015-11-24 22:08:25 -08:00
## [Documentation](http://momentjs.com/docs/)
2014-09-14 07:04:16 -04:00
2015-11-24 22:08:25 -08:00
## Port to ES6 (version 2.10.0)
2014-09-14 07:04:16 -04:00
2015-11-24 22:08:25 -08:00
Moment 2.10.0 does not bring any new features, but the code is now written in
es6 modules and placed inside `src/` . Previously `moment.js` , `locale/*.js` and
`test/moment/*.js` , `test/locale/*.js` contained the source of the project. Now
the source is in `src/` , temporary build (es5) files are placed under
`build/umd/` (for running tests during development), and the `moment.js` and
`locale/*.js` files are updated only on release.
2014-09-14 07:04:16 -04:00
2015-11-24 22:08:25 -08:00
If you want to use a particular revision of the code, make sure to run
`grunt transpile update-index` , so `moment.js` and `locales/*.js` are synced
with `src/*` . We might place that in a commit hook in the future.
2014-09-14 07:04:16 -04:00
2015-11-24 22:08:25 -08:00
## Upgrading to 2.0.0
2014-09-14 07:04:16 -04:00
2015-11-24 22:08:25 -08:00
There are a number of small backwards incompatible changes with version 2.0.0. [See the full descriptions here ](https://gist.github.com/timrwood/e72f2eef320ed9e37c51#backwards-incompatible-changes )
2014-09-14 07:04:16 -04:00
2015-11-24 22:08:25 -08:00
* Changed language ordinal method to return the number + ordinal instead of just the ordinal.
2014-09-14 07:04:16 -04:00
2015-11-24 22:08:25 -08:00
* Changed two digit year parsing cutoff to match strptime.
2014-09-14 07:04:16 -04:00
2015-11-24 22:08:25 -08:00
* Removed `moment#sod` and `moment#eod` in favor of `moment#startOf` and `moment#endOf` .
2014-09-14 07:04:16 -04:00
2015-11-24 22:08:25 -08:00
* Removed `moment.humanizeDuration()` in favor of `moment.duration().humanize()` .
2014-09-14 07:04:16 -04:00
2015-11-24 22:08:25 -08:00
* Removed the lang data objects from the top level namespace.
2014-09-14 07:04:16 -04:00
2015-11-24 22:08:25 -08:00
* Duplicate `Date` passed to `moment()` instead of referencing it.
2014-09-14 07:04:16 -04:00
2015-11-24 22:08:25 -08:00
## [Changelog](https://github.com/moment/moment/blob/develop/CHANGELOG.md)
2014-09-14 07:04:16 -04:00
2015-11-24 22:08:25 -08:00
## [Contributing](https://github.com/moment/moment/blob/develop/CONTRIBUTING.md)
2014-09-14 07:04:16 -04:00
2015-11-24 22:08:25 -08:00
We're looking for co-maintainers! If you want to become a master of time please
write to [ichernev ](https://github.com/ichernev ).
2014-09-14 07:04:16 -04:00
2015-11-24 22:08:25 -08:00
## License
2014-09-14 07:04:16 -04:00
2015-11-24 22:08:25 -08:00
Moment.js is freely distributable under the terms of the [MIT license ](https://github.com/moment/moment/blob/develop/LICENSE ).
2014-09-14 07:04:16 -04:00
2015-11-24 22:08:25 -08:00
[license-image]: http://img.shields.io/badge/license-MIT-blue.svg?style=flat
[license-url]: LICENSE
2014-09-14 07:04:16 -04:00
2015-11-24 22:08:25 -08:00
[npm-url]: https://npmjs.org/package/moment
[npm-version-image]: http://img.shields.io/npm/v/moment.svg?style=flat
[npm-downloads-image]: http://img.shields.io/npm/dm/moment.svg?style=flat
2014-09-14 07:04:16 -04:00
2015-11-24 22:08:25 -08:00
[travis-url]: http://travis-ci.org/moment/moment
[travis-image]: http://img.shields.io/travis/moment/moment/develop.svg?style=flat