Moment.js (A JavaScript Library to Manipulate Dates)

Introduction

This JavaScript Library helps to work with date and time. As we know, when we work on date and time using JavaScript, we encounter many challenges. So this library ultimately saves you time and effort because it provides a rich set of functions. By using them, you can directly validate, manipulate and format date values. Since this is a light-weight library, it is very easy to use without overhead. 

Background

This library is freely available. You can use either a minified or full version of this library as you require. In this library, all the operations are performed on a moment object so the date or time is stored in this library as a moment object only. So this moment object is the core of this entire library. You can find this library at Moment.js site's home page.

Using the Code

You can use this library with node.js or a browser. To use this library in Node.js, you can write the following:

npm install moment

var moment =require ('moment');
Moment.format();

And if you want to use this library, then you need to add this Moment.js library as in the following:

<script src="moment.js" temp_src="moment.js"></script>
<script>
moment().format();
</script>

1. If you want to get today's date or time:
   JavaScript

   var now=moment();

2. If you want to pass a date as a string:
   JavaScript

   var dt=moment("Dec 25, 1995");

3. Validate a date using isValid():
   JavaScript

   moment('122-22-2222').isVaid()

4. When passing a date as a string if you know the format, then you can specify the format:
   JavaScript

   moment("11-21-2013", "MM-DD-YYYY");

   We can specify the format from the table below:

   M.MM	MonthNumber (1-12)
   D,DD	Dayof month
   YY	2digit year
   m,mm	minutes
   h,hh	24hour time
   s,ss	Seconds
   S	Deciseconds
   SS	CentiSeconds
   SSS	Milliseconds

5. If you want to wrap a date object to moment:
   JavaScript

   var dat = new Date(2013, 10, 22);
   var wrap = moment(dat);

6. Fetch Date and time from a moment object:
   JavaScript

   moment().date();
   moment().date(Number);
   moment().days(Number | String);
   moment().days();// Number
   moment().dayOfYear(Number);
   moment().year(Number);
   moment().year();

   You can use many builtin methods to fetch all details.

7. Difference:

   If you want to find the difference between two moments, then there are many functions provided by moment.js.

   JavaScript

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

   • To get the difference in milliseconds:
   JavaScript

   var first = moments([2010, 0, 29]);
   var second = moments([2013, 1, 29]);
   alert(first.diff(second));

   • To get the difference in years, days or months, you can specify one more argument:
   JavaScript

   alert(first.diff(second,'days')); 
   alert(first.diff(second,'months')); 
   alert(first.diff(second,'years'));

   • To get a floating value, suppose in the case of years, you can pass one more argument as true then it will return the exact floating value: 
   JavaScript

   alert(first.diff(second,'years',true));

8. Convert to JSON

   If you want to convert moment to JSON, then you can directly use the toJSON() method:

   JavaScript

   moment().toJSON();

9. Manipulation
   • Add:
   JavaScript

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

   In place of days, you can write months, weeks, minutes, hours, seconds, and so on.

   JavaScript

   moment().add({days:7,months:1});

   You can use this object in literal format also.

   • Subtract
   JavaScript

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

10. Formatting
    JavaScript

    moment().format(String);

    Here, String is format of date like following:         

    JavaScript

    moment().format("dddd, MM Do YYYY, h:mm ");
    moment().format("ddd, hA,SS");

11. Some important functions for comparison:
    • IsBefore

    This function will check whether the first date is earlier than the second date:

    JavaScript

    moment().isBefore(Moment | String | Number | Date | Array, String);
    moment('2012-10-10').isBefore('2012-10-11');// true

    If you want to check which current date and time.

    JavaScript

    moment().isBefore();

    By default, it checks by miliseconds and if you want it to be restricted to some level for comparison, then you can specify that as in the following:

    JavaScript

    moment('2012-11-20').isBefore('2012-12-31','year'); //false

    • IsSame

    This function determines whether two dates are the same or not.

    JavaScript

    moment().isSame(Moment | String | Number | Date | Array, String);
    moment('2013-11-10').isSame('2013-11-10');// true

    You can specify which part you need to compare as in the following:

    JavaScript

    moment('2013-11-10').isSame('2013-10-21', 'year'); // true

    This will compare the year part of the date.

    If you do not specify a date, then it will use the current time by default:

    JavaScript

    moment().isSame();// true

    As in the methods above, moment.js also provides the following methods:

    JavaScript

    IsAfter() ;//check if a moment is after another moment.
    isLeapYear() : // check year is leap year or not.
    isMoment() ;//check variable is moment object or not.

    There are many other features and methods available. For more information, please refer to the documentation of moments.js.

References

• http://momentjs.com