node-dateformat

A node.js package for Steven Levithan’s excellent dateFormat() function.

Modifications

  • Removed the Date.prototype.format method. Sorry folks, but extending native prototypes is for suckers.
  • Added a module.exports = dateFormat; statement at the bottom

Usage

As taken from Steven’s post, modified to match the Modifications listed above:

  1. var dateFormat = require('dateformat');
  2. var now = new Date();
  4. // Basic usage
  5. dateFormat(now, "dddd, mmmm dS, yyyy, h:MM:ss TT");
  6. // Saturday, June 9th, 2007, 5:46:21 PM
  8. // You can use one of several named masks
  9. dateFormat(now, "isoDateTime");
  10. // 2007-06-09T17:46:21
  12. // ...Or add your own
  13. dateFormat.masks.hammerTime = 'HH:MM! "Can\'t touch this!"';
  14. dateFormat(now, "hammerTime");
  15. // 17:46! Can't touch this!
  17. // When using the standalone dateFormat function,
  18. // you can also provide the date as a string
  19. dateFormat("Jun 9 2007", "fullDate");
  20. // Saturday, June 9, 2007
  22. // Note that if you don't include the mask argument,
  23. // dateFormat.masks.default is used
  24. dateFormat(now);
  25. // Sat Jun 09 2007 17:46:21
  27. // And if you don't include the date argument,
  28. // the current date and time is used
  29. dateFormat();
  30. // Sat Jun 09 2007 17:46:22
  32. // You can also skip the date argument (as long as your mask doesn't
  33. // contain any numbers), in which case the current date/time is used
  34. dateFormat("longTime");
  35. // 5:46:22 PM EST
  37. // And finally, you can convert local time to UTC time. Simply pass in
  38. // true as an additional argument (no argument skipping allowed in this case):
  39. dateFormat(now, "longTime", true);
  40. // 10:46:21 PM UTC
  42. // ...Or add the prefix "UTC:" to your mask.
  43. dateFormat(now, "UTC:h:MM:ss TT Z");
  44. // 10:46:21 PM UTC
  46. // You can also get the ISO 8601 week of the year:
  47. dateFormat(now, "W");
  48. // 42

License

(c) 2007-2009 Steven Levithan stevenlevithan.com, MIT license.