dateformat是什么

什么是dateformat，A node.js package for Steven Levithan's excellent dateFormat() function.

dateformat使用教程帮助文档

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
• Added the placeholder 

  N

   to get the ISO 8601 numeric representation of the day of the week

Installation

[code]$ npm install dateformat
$ dateformat --help

Usage

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

[code]var dateFormat = require('dateformat');
var now = new Date();

// Basic usage
dateFormat(now, "dddd, mmmm dS, yyyy, h:MM:ss TT");
// Saturday, June 9th, 2007, 5:46:21 PM

// You can use one of several named masks
dateFormat(now, "isoDateTime");
// 2007-06-09T17:46:21

// ...Or add your own
dateFormat.masks.hammerTime = 'HH:MM! "Can\'t touch this!"';
dateFormat(now, "hammerTime");
// 17:46! Can't touch this!

// You can also provide the date as a string
dateFormat("Jun 9 2007", "fullDate");
// Saturday, June 9, 2007

// Note that if you don't include the mask argument,
// dateFormat.masks.default is used
dateFormat(now);
// Sat Jun 09 2007 17:46:21

// And if you don't include the date argument,
// the current date and time is used
dateFormat();
// Sat Jun 09 2007 17:46:22

// You can also skip the date argument (as long as your mask doesn't
// contain any numbers), in which case the current date/time is used
dateFormat("longTime");
// 5:46:22 PM EST

// And finally, you can convert local time to UTC time. Simply pass in
// true as an additional argument (no argument skipping allowed in this case):
dateFormat(now, "longTime", true);
// 10:46:21 PM UTC

// ...Or add the prefix "UTC:" or "GMT:" to your mask.
dateFormat(now, "UTC:h:MM:ss TT Z");
// 10:46:21 PM UTC

// You can also get the ISO 8601 week of the year:
dateFormat(now, "W");
// 42

// and also get the ISO 8601 numeric representation of the day of the week:
dateFormat(now,"N");
// 6

Mask options

d

dd

ddd

dddd

m

mm

mmm

mmmm

yy

yyyy

h

hh

H

HH

M

MM

N

o

s

ss

S

d

l

L

t

tt

T

TT

W

Z

'...'

"..."

UTC:

Named Formats

default

ddd mmm dd yyyy HH:MM:ss

shortDate

m/d/yy

mediumDate

mmm d, yyyy

longDate

mmmm d, yyyy

fullDate

dddd, mmmm d, yyyy

shortTime

h:MM TT

mediumTime

h:MM:ss TT

longTime

h:MM:ss TT Z

isoDate

yyyy-mm-dd

isoTime

HH:MM:ss

isoDateTime

yyyy-mm-dd'T'HH:MM:ss

isoUtcDateTime

UTC:yyyy-mm-dd'T'HH:MM:ss'Z'

Localization

Day names, month names and the AM/PM indicators can be localized by passing an object with the necessary strings. For example:

[code]var dateFormat = require('dateformat');
dateFormat.i18n = {
dayNames: [
'Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat',
'Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'
],
monthNames: [
'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec',
'January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'
],
timeNames: [
'a', 'p', 'am', 'pm', 'A', 'P', 'AM', 'PM'
]
};