It's a jQuery Plugin to format Date outputs using JavaScript.
jquery-dateFormat - jQuery Plugin to format Date outputs using JavaScript - Having less than 5kb, jquery-dateFormat is the smallest date format library available!
Download latest jquery.dateFormat.js or jquery.dateFormat.min.js.
* jquery-dateFormat.js
* jquery-dateFormat.min.js
* dateFormat.js (pure Javascript, no jQuery dependency)
* dateFormat.min.js (pure Javascript, no jQuery dependency)
You can use jquery-dateFormat without jQuery. You just need to import the dateFormat.js above and instead of formatting with $.format(...) you should use DateFormat.format(...).
If you use jQuery Validate plugin you must use jquery-dateFormat without jQuery.
The patterns to formatting are based on java.text.SimpleDateFormat.
* yy = short year
* yyyy = long year
* M = month (1-12)
* MM = month (01-12)
* MMM = month abbreviation (Jan, Feb ... Dec)
* MMMM = long month (January, February ... December)
* d = day (1 - 31)
* dd = day (01 - 31)
* ddd = day of the week in words (Monday, Tuesday ... Sunday)
* E = short day of the week in words (Mon, Tue ... Sun)
* D - Ordinal day (1st, 2nd, 3rd, 21st, 22nd, 23rd, 31st, 4th...)
* h = hour in am/pm (0-12)
* hh = hour in am/pm (00-12)
* H = hour in day (0-23)
* HH = hour in day (00-23)
* mm = minute
* ss = second
* SSS = milliseconds
* a = AM/PM marker
* p = a.m./p.m. marker
* 1982-10-15T01:10:20+02:00
* 1982-10-15T01:10:20Z
* Thu Oct 15 01:10:20 CET 1982
* 1982-10-15 01:10:20.546
* Thu Oct 15 1982 01:10:20 GMT-0800 (PST)
* Thu Oct 15 1982 01:10:20 GMT+0800 (China Standard Time)
* Thu Oct 15 1982 01:10:20 GMT+0200 (W. Europe Daylight Time)
* 1982-10-15CET01:10:20
* JavaScript: new Date().getTime()
``javascript`
Output
`
=> Test: 18/12/2009
=> 13~01~2010
`html`
2009-12-18 10:54:50.546
2009-12-18 10:54:50.546
`javascript
jQuery(function() {
var shortDateFormat = 'dd/MM/yyyy';
var longDateFormat = 'dd/MM/yyyy HH:mm:ss';
jQuery(".shortDateFormat").each(function (idx, elem) {
if (jQuery(elem).is(":input")) {
jQuery(elem).val(jQuery.format.date(jQuery(elem).val(), shortDateFormat));
} else {
jQuery(elem).text(jQuery.format.date(jQuery(elem).text(), shortDateFormat));
}
});
jQuery(".longDateFormat").each(function (idx, elem) {
if (jQuery(elem).is(":input")) {
jQuery(elem).val(jQuery.format.date(jQuery(elem).val(), longDateFormat));
} else {
jQuery(elem).text(jQuery.format.date(jQuery(elem).text(), longDateFormat));
}
});
});
`
Output
`
=> 18/12/2009
=> 18/12/2009 10:54:50
jQuery.format.prettyDate(value) returns a string representing how long ago the date represents
* value = String representing ISO time or date in milliseconds or javascript Date object
`javascript`
jQuery.format.prettyDate(new Date()) // => "just now"
jQuery.format.prettyDate(new Date().getTime()) // => "just now"
jQuery.format.prettyDate("2008-01-28T20:24:17Z") // => "2 hours ago"
jQuery.format.prettyDate("2008-01-27T22:24:17Z") // => "Yesterday"
jQuery.format.prettyDate("2008-01-26T22:24:17Z") // => "2 days ago"
jQuery.format.prettyDate("2008-01-14T22:24:17Z") // => "2 weeks ago"
jQuery.format.prettyDate("2007-12-15T22:24:17Z") // => "more than 5 weeks ago"
jQuery.format.toBrowserTimeZone(value, format) converts into browsers timezone.
* value = String representing date in ISO time ("2013-09-14T23:22:33Z") or String representing default JAXB formatting of java.util.Date ("2013-09-14T16:22:33.527-07:00") or String representing Unix Timestamp (Sat Sep 14 2013 16:22:33 GMT-0700 (PDT)) or javascript date object.jQuery.format.date
* format = All input formats valid for are valid for this method. The defaut format is MM/dd/yyyy HH:mm:ss.
`javascript
var date1 = "2013-09-14T23:22:33Z";
var date2 = "2013-09-14T16:22:33.527-07:00";
var date3 = "Sat Sep 14 2013 16:22:33 GMT-0700 (PDT)";
$.format.toBrowserTimeZone(date1)
$.format.toBrowserTimeZone(date2)
$.format.toBrowserTimeZone(date3)
`
To compile jquery-dateFormat (generate dist files):
`sh`
npm run compile
Tests are written using Jasmine. To run the test suite with PhantomJS, run npm run test. To run the test suite in your default browser, run npm run test:browser`.
jquery-dateFormat is released under the MIT License.
You're welcome to make your contributions and send them as a pull request.
Thanks to all contributors.