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: 874
Star: 47.6k
Fork: 7.2k
Last update: Nov 24, 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

308 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 193
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 152
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

valueOf() issues

Describe the bug Directly obtaining valueOf() and utc(). valueOf() obtains the same value

To Reproduce Steps to reproduce the behavior: The timestamp of Dongba District is the same as the timestamp obtained from the zero time zone

Expected behavior The timestamp of Dongba District and the timestamp of Zero Time Zone should be interpolated

Screenshots image

Desktop (please complete the following information):

  • OS: [window]
  • Browser [chrome]
  • Version [119.0.6045.160]
opened Nov 22, 2023 by newboolean 0
Open

Feat/ph locale

Add Philippines 🇵🇭 Locale

opened Nov 3, 2023 by mowglimecha9 1
Open

Fix czech months (format and standalone swap)

Signed-off-by: Martin Mayer [email protected]

Format and standalone month names are swapped. e.g. 1.12.2023 should be "1. prosince 2023", not "1. prosinec 2023" and 12.2023 should be "prosinec 2023", not "prosince 2023"

opened Oct 31, 2023 by mkmayer 1
Open

gets wrong date from date string

Describe the bug gets wrong date from date string

To Reproduce ` Moment.locale('ee'); var dt = '2016-05-02';

console.log(Moment(dt).format('d.m.Y')); `

Expected behavior 02.05.2016

Real output 1.0.2016

opened Oct 25, 2023 by kriit24 3
Open

Add support for startOf(multiple, "interval") or startOf(Duration) to get a beginning of the interval as multiple units #5831

latest postgres (14+) above has a SQL function called date_bin can for example,

date_bin('15 minutes', timestamp)

to get beginning to a multiple of the interval 15 minutes

9.9.3. date_bin

but some applications still running older Postgres versions, or other SQL variants, want to simulate this feature from application layer with momentjs:

.startOf(15, "minute")
.startOf(moment.duration(2, 'd'))    <= Duration
opened Oct 23, 2023 by tx0c 0
Open

Wrong apostrophe sign used in Ukrainian locale

Wrong apostrophe sign used in the Ukrainian week day localization of a _п'ятниця_.

The ’ or also known as U+2019 (right single quotation mark &rsquo;) used to represent an apostrophe. Should be ʼ aka U+02BC (modifier letter apostrophe &#700;).

Please refer to this article, explainig spesific usage of an apostrophe: wiki/Apostrophe

Article in Ukrainian language: uk/wiki/Апостроф

In Ukrainian language aphstrophe represents as a special letter apostrophe. U+02BC is rendered identically to U+2019 in the Unicode code charts, and the standard cautions that one should never assume this code is used in any language.

This typo causes a lot of frustrations especially if one relies on a used language in an app development.

Code reference: locale/uk.js line:43 locale/uk.js line:47 locale/uk.js line:51

opened Oct 15, 2023 by GeorgeSteshenko 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
    84
    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
    11.2k
    🍞📅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.