Home / JavaScript / Date and Time

Parse, validate, manipulate, and display dates in javascript.

A lightweight JavaScript date library for parsing, validating, manipulating, and formatting dates. Documentation Port to ECMAScript 6 (version 2.10.0) Moment 2.10.0 does not bring any new features, but the code is now w
Information
Category: JavaScript / Date and Time
Watchers: 868
Star: 47.3k
Fork: 7.1k
Last update: Mar 25, 2023
Resource links
momentjs.com
https://github.com/moment/moment
Popular

Join the chat at https://gitter.im/moment/moment

NPM version NPM downloads MIT License Build Status Coverage Status FOSSA Status SemVer compatibility

A lightweight JavaScript date library for parsing, validating, manipulating, and formatting dates.

Documentation

Port to ECMAScript 6 (version 2.10.0)

Moment 2.10.0 does not bring any new features, but the code is now written in ECMAScript 6 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 (ECMAScript 5) files are placed under build/umd/ (for running tests during development), and the moment.js and locale/*.js files are updated only on release.

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.

Upgrading to 2.0.0

There are a number of small backwards incompatible changes with version 2.0.0. See the full descriptions here

  • Changed language ordinal method to return the number + ordinal instead of just the ordinal.

  • Changed two digit year parsing cutoff to match strptime.

  • Removed moment#sod and moment#eod in favor of moment#startOf and moment#endOf.

  • Removed moment.humanizeDuration() in favor of moment.duration().humanize().

  • Removed the lang data objects from the top level namespace.

  • Duplicate Date passed to moment() instead of referencing it.

Changelog

Contributing Open Source Helpers

We're looking for co-maintainers! If you want to become a master of time please write to ichernev.

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.

Frequently asked questions

See FAQ.md.

License

Moment.js is freely distributable under the terms of the MIT license.

FOSSA Status

258 Open More issues
Closed

Duration missing features

I'm working on a project and momentjs is really useful for date manipulation so thanks for that.

To give you an example, we're making somekind of store for plane tickets. The duration.humanize() function is way to imprecise for us.

For example when leaving at: 12:00 and landing at 13:30. It will round it to 2 hours. But we need some kind of granularity which is missing from momentjs.

humanize could default to 1 level of precision starting from the highest value.

// 1:30
duration.humanize()
2 hour
duration.humanize({precision: 2})
1 hour 30 minutes
duration.humanize({precision: 3})
1 hour 30 minutes 0 seconds

The second problem is when there is the number 0. Momentjs translates it as "few seconds". I'm not so sure how it could be achieved but it would be cool to have some kind of formatting.

// 3 days and 0 minutes
duration.format('D [and] M')
> 3 days and 0 minutes
duration.format('H [and] M')
> 72 hours and 0 minutes
duration.format('H [and] m')
> 72 hours and few minutes

That way the highest value could be mapped in the format. So even if there is 1 year, the format tells us how to display it correctly. I'd be happy to push a commit for that because it's very useful and having to do it by hand when momentjs already handle localization feels bad.

New Feature 
opened Oct 10, 2012 by llacroix 192
Closed

make moment mostly immutable

There has been a lot of discussions about this. Here's the proposal:

The following mutable methods will become immutable in 3.0.0: utc, local, zone, add, subtract, startOf, endOf, lang, also in duration: add, subtract, and lang.

As a start, all methods will be duplicated with methodNameMute variants. We also need immutable variants named methodNameImmute. From 3.0 the plain old methods will start using the immutable option by default.

What is debatable is:

  • should lang be made immutable
  • should all the getters/setters (including get/set) be made immutable too
  • naming of the mutable and immutable versions of the methods
  • and of course -- should we do the switch, or just stop at the immutable API

The good part is we can make immutable versions of the methods today and decide later on what to do. If we switch it would also mean the 2.x branch would be around for quite some time after 3.x is out.

@icambron @timrwood @gregwebs @yang @lfnavess @soswow @langalex

Enhancement 
opened Jul 3, 2014 by ichernev 163
Closed

Webpack Error: Cannot find module "./locale" after updating to 2.19.0

Edit: If you set your dependency to 2.18.1, everything will be fine. We are coordinating with some other libraries to find a permanent solution Edit 2 : Set "moment": "2.18.1" in your package.json Edit 3: We believe this is fixed.

Hello. Using create-react-app. After updating moment to 2.19.0 i have this error on load :

Error: Cannot find module "./locale" -> 9 stack frames were collapsed. ./src/utils/Utils.js src/utils/Utils.js:1

1 | import moment from 'moment'

opened Oct 10, 2017 by GautierT 151
Closed

Be careful when falling back to Date constructor

If you clicked on the warning link and landed here:

moment construction using a non-iso string is deprecated. What this means is you can safely do

> moment("2014-04-25T01:32:21.196Z");  // iso string, utc timezone
> moment("2014-04-25T01:32:21.196+0600");  // iso string with timezone
> moment("2014 04 25", "YYYY MM DD"); // string with format

but you can't do reliably (therefore its being deprecated)

> moment("2014/04/25");
> moment("Thu Apr 24 2014 12:32:21 GMT-0700 (PDT)");
> moment("some random string that looks like date");

In the upcoming releases a few more well defined formats might be added, but the general idea of using any random string to construct a date is no more. If you really want that behavior just do moment(new Date("random string that contains date")), but moment won't be responsible for such convertions. Read below for the rationale about the change

As described in https://github.com/moment/moment/issues/1403#issuecomment-31961590, but also recent debugging c4d9f6e and 94d6c90 caused by https://travis-ci.org/moment/moment/builds/16672288 brings me to the conclusion that

using Date to create a moment from string, passed from the user is extremely unpredictable, and it turns out to work somewhat and then bite you in an edge case when you're not careful

So I think we need an option to disable it, for tests at the very least. I've debugged that numerous times thank to our old friend IE6 and friends.

You'd pass a string only, hoping that it would hit one of the predefined formats, but instead it hits Date and it sort-of works, sometimes. I think it should be clear to users when they're hitting this case, and that it might not work well on all browsers.

The only use-case for using Date to parse input is when a) it is entered by a web user (moment's user's user :)) and b) the web user can see how we're interpreting the date entered. Every other case is just silently waiting to break at some point.

Enhancement 
opened Jan 9, 2014 by ichernev 136
Closed

Modularize moment.js, make the core as light as possible

I remember when moment was a "lightweight" library, right now at 12kb (gziped no less) for, what it's in most cases, just very very simple date manipulation.

A simple solution to this problem would be to modularize momentjs so at least for environments like browerify, webpack and such a minimal version can be obtained.

eg.

Regular usage can stay the same,

// get everything under the sun
var moment = require('moment');

Modular usage could look like this,

// get core, the core does nothing, no validation, no nothing
// it would only define a internal storage structure and the bare minimum
// methods for getting values out of it: day, month, year, etc (no "format" 
// functions or "fromNow" since you might not even want to use them)
var moment = require('moment/core');

// add plugins for all the stuff you need, if you ever want ALL of them you 
// just include the directory instead (node/browserify/webpack will pick up
// a index.js inside it that would have all the things)
moment.plugin([

    // if you know this is all the parsers you need this is all you add
    require('moment/plugins/parser/yyyy-mm-dd-time'),
    require('moment/plugins/parser/unixtime'),

    require('moment/plugins/validator/yyyy-mm-dd-time'),
    // if we don't use unixtime locally, only on server we dont care for that
    // when it comes to validation

    require('moment/plugins/fromNow'),
    require('moment/plugins/toUnixTime'),

    // with a modular structure we can add 3rd party stuff really easily
    require('moment-phpstyle-format'),
    require('moment-chained-functions-format')

]);

// lock in the configuration so that calling plugin method throw and exception
// this would be irreversible but you can get a unlocked version by calling copy
// this will force people to get a "copy" of the configuration before doing 
// anything stupid -- or help them find the mistake if they add it later
moment.lock();

// you now just include this file where you need it
module.exports = moment;

Let's pretend the above is in something like lib/moment and represents your default boilerplate configuration for it. Obviously you may eventually encounter situations where you need more advanced functions. If we add to the default boilerplate we unfortunately add to every other context that doesn't need it. This is a big bummer if we're trying to keep client size down with things like webpack code splitting.

However, so long as the modular system is capable of being extending any time there's no problem whatsoeve. Ideally, to avoid subtle race condition bugs, we should be able to get a new "advanced" version as a separate instance:

// load boilerplate we defined previously
// we request a copy of the instance so no funny business happens
var moment = require('lib/moment').copy(); 

// we can also create a separate boilerplate if we re-use this a lot
moment.plugin(require('expensive-internationalization-timezone-nonsense'));
moment.lock(); // lock the new copy just in case its passed around

// moment instances should be able to do a quick copy between instances
// to ensure functionality, ie. moment(createdAt) could just swap plugin pointers

Now only the module that actually uses that feature pays the cost. If you use moment in 100 places and only 1 actually needs internationalization just that one place will ever pay for it. This applies to all functions, all the core needs to do is store a plain date object and some getters. Is everything you do just pass unix time from the server? you can just have unixtime parser. Do you only ever validate dates on the server? you can skip on any and all validation, etc.

It's effectively as light as you building your own specialized helpers. And much like projects like gulp, postcss and so on the community can contribute easily to it though easily maintainable chunks.

And in this way, momentjs can, once again, be called "lightweight javascript date library".

Enhancement rewrite 
opened May 13, 2015 by srcspider 129
Closed

duration formatting

We've touched on this before in #463 and #879 but never really talked about it directly in its own issue.

We need a method for formatting durations similar to how we format dates. It should be as simple as:

moment.duration(x).format("H:mm:ss")

Note that the formatting tokens would have to carry slightly different meaning, since we're representing an elapsed duration of time, rather than a time-of-day. I suggest the following:

  • hh would mean "hours remainder after accounting for days"
  • h would be the single digit form of hh
  • HH would mean "total whole hours"
  • H would be the single digit form of HH
  • HHH would mean "total hours including decimals" - although that can currently be done with duration.asHours(), so this might not be necessary.

Similar formatting would apply for other units. In this context, the highest unit would be a "day", which would be a standard day consisting of 24 standard hours. It wouldn't make sense to measure years or months with this due to calendaring issues.

Note, this came up recently (again) on StackOverflow in this question. The user was looking for something like duration.format("H:mm:ss"). This is the workaround:

Math.floor(duration.asHours()) + moment.utc(duration.asMilliseconds()).format(":mm:ss")

This works, but it feels hacky. This should be built in.

New Feature Up-For-Grabs 
opened Sep 4, 2013 by mattjohnsonpint 118
Open

[Nuxt3] moment.locale not set new locale

Describe the bug moment.locale not set new locale, instead of this it always return 'en' UPD: It seems in ssr mode it works fine, but on client is not

To Reproduce https://stackblitz.com/edit/nuxt-starter-fy3grx?file=app.vue

opened Mar 20, 2023 by ideafm 0
Open

Add ability to specify year before parsing, or auto-guess the year

I need parse string like this: moment('Mon Dec 06, 9:30am CST', 'ddd MMM DD, h:mma') Today is 2023, and this string is from 2021, so if you try this: moment('Mon Dec 06 2021, 9:30am CST', 'ddd MMM DD YYYY, h:mma').isValid() it's gonna work.

I'd like to add some ability to specify the year before parsing happens, like moment.year(2021).parse('Mon Dec 06, 9:30am CST', 'ddd MMM DD, h:mma') Or the moment can try to auto-guess the year by trying 2023, then 2022, and so on (I don't know how far into the past it makes sense to travel, but i guess there can be some limit)

Thanks

opened Mar 7, 2023 by dmitrygorbenko 0
Open

2.25.0+ Changed Add/Subtract Behavior for specific invalid input

Describe the bug Using .add() or .subtract() – possibly other methods – passing a new Date() or moment object as the first argument creates an invalid date. This is inconsistent with the behavior in 2.24.0 and inconsistent with other invalid inputs I tested.

To Reproduce Steps to reproduce the behavior:

  1. moment('2023-01-01').add(new Date(), 'days').format() produces -0NaN--NaN--NaNT-NaN:-NaN:-NaN+00:00
  2. moment('2023-01-01').add({}, 'days').format() produces 2023-01-01T00:00:00-05:00 (for EST)

Expected behavior A clear and concise description of what you expected to happen. The behavior of .add() and .subtract() should be consistent for invalid data.

Screenshots If applicable, add screenshots to help explain your problem. moment-2 24 0-invalid-input moment-2 29 4-invalid-input

Desktop (please complete the following information):

  • OS: macOS 13.2.1
  • Browser Chrome
  • Version 110.0.5481.177 Also tested on Node 16.16.0 (see screenshots)

Moment-specific environment

  • The time zone setting of the machine the code is running on: EST
  • The time and date at which the code was run: 2023-02-28T16:45:00-05:00
  • Other libraries in use: none

Please run the following code in your environment and include the output:

console.log((new Date()).toString())
console.log((new Date()).toLocaleString())
console.log((new Date()).getTimezoneOffset())
console.log(navigator.userAgent)
console.log(moment.version)

In RunJS:

'Tue Feb 28 2023 16:50:21 GMT-0500 (Eastern Standard Time)'
'2/28/2023, 4:50:21 PM'
300
'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) runjs/2.7.5 Chrome/106.0.5249.168 Electron/21.2.2 Safari/537.36'
'2.29.4'

Additional context This is not a serious concern for us, but it is a change that didn't appear to be documented, though I may have missed it. We discovered this as an invalid moment was provided to a datepicker and "broke" .isBefore() and .isAfter() checks for disabling out-of-range days.

opened Feb 28, 2023 by oculus42 0
Open

Remove Day.js from recommended alternatives to Moment.js

Hi! Please remove Day.js from the recommended alternatives to Moment. The library has terrible bugs with time zone handling (see for example https://github.com/iamkun/dayjs/issues/1805) and the maintainer is completely unresponsive in responding to the bug reports. I know several developers have followed the advice in the Moment docs and have realised the library is unusable only after spending considerable effort in taking it into use.

opened Feb 25, 2023 by sulkaharo 0
Open

Correct month subjective in PL

If the Date format is D. MMMM the wrong Case is used.

I made the . (Dot) optional, so it will still match in both cases

opened Feb 14, 2023 by idoodler 1
Open

Invalid date in `ar-sa` locale

Describe the bug Use ar-sa locale in moment. If use arabic date with ١٢٣٤٥٦٧٨٩٠ number date going to invalid.

To Reproduce Set ar-sa locale

const testDate = '٧ فبراير ٢٠٢٣ ، ٢:٠٠ م';
moment.locale('ar-sa');

const momentInst = moment(testDate);

console.log(momentInst.isValid());  // return false

Expected behavior Date might be valid

Additional context It look like need convert also month name and etc. to en locale. Always put en date to moment. https://github.com/moment/moment/blob/develop/locale/ar-sa.js#L96

Maybe authors arabic locale know this issue @marwahaha @ichernev

opened Feb 13, 2023 by zgeist 0

Contents

    malcommac Parse, validate, manipulate, and display dates, time and timezones in Swift
    NaturalIntelligence Validate XML, Parse XML to JS/JSON and vise versa, or parse XML to Nimn rapidly without C/C++ based libraries and no callback
    sindresorhus Parse JSON with more helpful errors
    fightbulc Parse, validate, manipulate, and display dates in PHP w/ i18n support. Inspired by moment.js
    atlassian Validate a package.json file
    logaretm vee-validate - Simple Vue.js input validation plugin.
    syamilmj Para - Declarative way to parse and validate parameters
    sabre-io The VObject library for PHP allows you to easily parse and manipulate iCalendar and vCard objects
    liyansong2018 ELF static analysis and injection framework that parse, manipulate and camouflage ELF files.
    ianstormtaylor A simple and composable way to validate data in JavaScript (or TypeScript).
    rickharrison Lightweight JavaScript form validation library inspired by CodeIgniter.
    arrow-py Better dates & times for Python
    charliekassel A simple Vue.js datepicker component. Supports disabling of dates, inline mode, translations
    charliekassel vuejs-datepicker - A simple Vue.js datepicker component. Supports disabling of dates, inline mode, translations.
    ShootrNetwork Library to validate username, email and passwords
    maize-tech Easily validate data attributes through a remote request
    r1chardj0n3s Parse strings using a specification based on the Python format() syntax.
    softvu :email: Parse SPF (sender policy framework) records
    yoshuawuyts Parse hyperscript class notation
    lukeed Quickly parse & match URLs
    allenai Science-parse version 2
    Share this repo

    Related Repos


    Date and Time
    37.3k
    ⏰ Day.js 2kB immutable date-time library alternative to Moment.js with the same modern API
    iamkun English | 简体中文 | 日本語 | Português Brasileiro | 한국어 | Español (España) | Русский Fast 2kB alternative to Moment.js with the same modern API Day.js is a
     
    Date and Time
    8
    Format a date with timezone
    samverschueren tz-format Format a date with timezone: 2015-11-30T10:40:35+01:00 Install $ npm install --save tz-format Usage const format = require('tz-format'); f
     
    Date and Time
    3.6k
    Timezone support for moment.js
    moment Moment Timezone IANA Time zone support for Moment.js Project Status Moment-Timezone is an add-on for Moment.js. Both are considered legacy projects, n
     
    Date and Time
    3.8k
    The original jQuery plugin that makes it easy to support automatically updating fuzzy time...
    rmm5t timeago: a jQuery plugin Timeago is a jQuery plugin that makes it easy to support automatically updating fuzzy timestamps (e.g. "4 minutes ago" or "ab
     
    Date and Time
    829
    A timezone-enabled, drop-in replacement for the stock JavaScript Date
    mde TimezoneJS.Date A timezone-enabled, drop-in replacement for the stock JavaScript Date. The timezoneJS.Date object is API-compatible with JS Date, with
     
    Date and Time
    4.6k
    :clock8: :hourglass: timeago.js is a tiny(2.0 kb) library used to format date with `*** ti...
    hustcc timeago.js timeago.js is a nano library(less than 2 kb) used to format datetime with *** time ago statement. eg: '3 hours ago'. i18n supported. Time a
     
    Date and Time
    2k
    Lightweight and simple JS date formatting and parsing
    taylorhakes fecha Lightweight date formatting and parsing (~2KB). Meant to replace parsing and formatting functionality of moment.js. NPM npm install fecha --save
     
    Date and Time
    81
    Framework-agnostic, highly-customizable Vanilla JavaScript datepicker with zero dependenci...
    mikecoj Framework-agnostic, highly-customizable Vanilla JavaScript datepicker with zero dependencies.
     
    Date and Time
    39
    utility to estimate the reading time
    syntax-tree hast utility to estimate the reading time, taking readability of the document and a target age group into account.
     
    Date and Time
    13
    A Codemod to migrate from moment.js to day.js
    rajasegar A Codemod to migrate from moment.js to day.js
     
    Date and Time
    73
    JavaScript parser of natural language time periods
    RoyalIcing JavaScript parser of natural language time periods
     
    Date and Time
    16
    Clubhouse Thailand Community Calendar
    clousehub Clubhouse Thailand Community Calendar
     
    Date and Time
    10.7k
    🍞📅A JavaScript calendar that has everything you need.
    nhn A JavaScript schedule calendar that is full featured. Now your service just got the customizable calendar.
     
    Date and Time
    454
    Duet Date Picker is an open source version of Duet Design System’s WCAG 2.1 compliant date...
    duetds Duet Date Picker is an open source version of Duet Design System’s WCAG 2.1 compliant date picker.
     
    Date and Time
    10
    📦 A package that lets you know how many days before that date.
    Sh031224 📦 A package that lets you know how many days before that date.