Merge "Improve docs for Title::getInternalURL/getCanonicalURL"
[lhc/web/wiklou.git] / resources / lib / moment / README.md
1 [![Join the chat at https://gitter.im/moment/moment](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/moment/moment?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
2
3 [![NPM version][npm-version-image]][npm-url] [![NPM downloads][npm-downloads-image]][downloads-url] [![MIT License][license-image]][license-url] [![Build Status][travis-image]][travis-url]
4 [![Coverage Status](https://coveralls.io/repos/moment/moment/badge.svg?branch=develop)](https://coveralls.io/r/moment/moment?branch=develop)
5 [![FOSSA Status](https://app.fossa.io/api/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fmoment%2Fmoment.svg?type=shield)](https://app.fossa.io/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fmoment%2Fmoment?ref=badge_shield)
6 [![SemVer compatibility](https://api.dependabot.com/badges/compatibility_score?dependency-name=moment&package-manager=npm_and_yarn&version-scheme=semver)](https://dependabot.com/compatibility-score.html?dependency-name=moment&package-manager=npm_and_yarn&version-scheme=semver)
7
8 A lightweight JavaScript date library for parsing, validating, manipulating, and formatting dates.
9
10 **[Documentation](http://momentjs.com/docs/)**
11
12 ## Port to ECMAScript 6 (version 2.10.0)
13
14 Moment 2.10.0 does not bring any new features, but the code is now written in
15 ECMAScript 6 modules and placed inside `src/`. Previously `moment.js`, `locale/*.js` and
16 `test/moment/*.js`, `test/locale/*.js` contained the source of the project. Now
17 the source is in `src/`, temporary build (ECMAScript 5) files are placed under
18 `build/umd/` (for running tests during development), and the `moment.js` and
19 `locale/*.js` files are updated only on release.
20
21 If you want to use a particular revision of the code, make sure to run
22 `grunt transpile update-index`, so `moment.js` and `locales/*.js` are synced
23 with `src/*`. We might place that in a commit hook in the future.
24
25 ## Upgrading to 2.0.0
26
27 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)
28
29 * Changed language ordinal method to return the number + ordinal instead of just the ordinal.
30
31 * Changed two digit year parsing cutoff to match strptime.
32
33 * Removed `moment#sod` and `moment#eod` in favor of `moment#startOf` and `moment#endOf`.
34
35 * Removed `moment.humanizeDuration()` in favor of `moment.duration().humanize()`.
36
37 * Removed the lang data objects from the top level namespace.
38
39 * Duplicate `Date` passed to `moment()` instead of referencing it.
40
41 ## [Changelog](https://github.com/moment/moment/blob/develop/CHANGELOG.md)
42
43 ## [Contributing](https://github.com/moment/moment/blob/develop/CONTRIBUTING.md) [![Open Source Helpers](https://www.codetriage.com/moment/moment/badges/users.svg)](https://www.codetriage.com/moment/moment)
44
45 We're looking for co-maintainers! If you want to become a master of time please
46 write to [ichernev](https://github.com/ichernev).
47
48 In addition to contributing code, you can help to triage issues. This can include reproducing bug reports, or asking for vital information such as version numbers or reproduction instructions. If you would like to start triaging issues, one easy way to get started is to [subscribe to moment/moment on CodeTriage](https://www.codetriage.com/moment/moment).
49
50 ## License
51
52 Moment.js is freely distributable under the terms of the [MIT license](https://github.com/moment/moment/blob/develop/LICENSE).
53
54 [![FOSSA Status](https://app.fossa.io/api/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fmoment%2Fmoment.svg?type=large)](https://app.fossa.io/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fmoment%2Fmoment?ref=badge_large)
55
56 [license-image]: http://img.shields.io/badge/license-MIT-blue.svg?style=flat
57 [license-url]: LICENSE
58
59 [npm-url]: https://npmjs.org/package/moment
60 [npm-version-image]: http://img.shields.io/npm/v/moment.svg?style=flat
61 [npm-downloads-image]: http://img.shields.io/npm/dm/moment.svg?style=flat
62 [downloads-url]: https://npmcharts.com/compare/moment?minimal=true
63
64 [travis-url]: http://travis-ci.org/moment/moment
65 [travis-image]: http://img.shields.io/travis/moment/moment/develop.svg?style=flat