1 # time-stamp [![NPM version](https://img.shields.io/npm/v/time-stamp.svg?style=flat)](https://www.npmjs.com/package/time-stamp) [![NPM downloads](https://img.shields.io/npm/dm/time-stamp.svg?style=flat)](https://npmjs.org/package/time-stamp) [![Build Status](https://img.shields.io/travis/jonschlinkert/time-stamp.svg?style=flat)](https://travis-ci.org/jonschlinkert/time-stamp)
3 > Get a formatted timestamp.
7 Install with [npm](https://www.npmjs.com/):
10 $ npm install time-stamp --save
16 var timestamp = require('time-stamp');
21 timestamp('YYYY:MM:DD');
24 timestamp('[YYYY:MM:DD]');
27 timestamp('YYYY/MM/DD');
57 * `YYYY`: full year (ex: **2015**)
58 * `MM`: month (ex: **04**)
59 * `DD`: day (ex: **01**)
60 * `HH`: hours (ex: **12**)
61 * `mm`: minutes (ex: **59**)
62 * `ss`: seconds (ex: **09**)
63 * `ms`: milliseconds (ex: **532**)
67 You might also be interested in these projects:
69 * [days](https://www.npmjs.com/package/days): Days of the week. | [homepage](https://github.com/jonschlinkert/days)
70 * [iso-week](https://www.npmjs.com/package/iso-week): Get the ISO week of the year. | [homepage](https://github.com/jonschlinkert/iso-week)
71 * [month](https://www.npmjs.com/package/month): Get the name or number of the current month or any month of the year. | [homepage](https://github.com/datetime/month)
72 * [months](https://www.npmjs.com/package/months): Months of the year. | [homepage](https://github.com/jonschlinkert/months)
73 * [o-clock](https://www.npmjs.com/package/o-clock): Simple utility for displaying the time in 12-hour clock format. | [homepage](https://github.com/jonschlinkert/o-clock)
74 * [seconds](https://www.npmjs.com/package/seconds): Get the number of seconds for a minute, hour, day and week. | [homepage](https://github.com/jonschlinkert/seconds)
75 * [week](https://www.npmjs.com/package/week): Get the current week number. | [homepage](https://github.com/jonschlinkert/week)
76 * [weekday](https://www.npmjs.com/package/weekday): Get the name and number of the current weekday. Or get the name of the… [more](https://www.npmjs.com/package/weekday) | [homepage](https://github.com/jonschlinkert/weekday)
77 * [year](https://www.npmjs.com/package/year): Simple utility to get the current year with 2 or 4 digits. | [homepage](https://github.com/jonschlinkert/year)
81 Pull requests and stars are always welcome. For bugs and feature requests, [please create an issue](https://github.com/jonschlinkert/time-stamp/issues/new).
85 Generate readme and API documentation with [verb](https://github.com/verbose/verb):
88 $ npm install verb && npm run docs
91 Or, if [verb](https://github.com/verbose/verb) is installed globally:
99 Install dev dependencies:
102 $ npm install -d && npm test
109 Follow me on GitHub or Twitter for updates about time-stamp and my other libraries:
111 * [github/jonschlinkert](https://github.com/jonschlinkert)
112 * [twitter/jonschlinkert](http://twitter.com/jonschlinkert)
116 Copyright © 2016, [Jon Schlinkert](https://github.com/jonschlinkert).
117 Released under the [MIT license](https://github.com/jonschlinkert/time-stamp/blob/master/LICENSE).
121 _This file was generated by [verb](https://github.com/verbose/verb), v, on April 07, 2016._