time-stamp

Get a formatted timestamp.

Please consider following this project's author, Jon Schlinkert, and consider starring the project to show your :heart: and support.

• Install
• Usage
• Customizing the timestamp
• Release history
  • v2.0.0
• About

(TOC generated by verb using markdown-toc)

Install

Install with npm:

1$ npm install --save time-stamp

Usage

1const timestamp = require('time-stamp');
2
3console.log(timestamp());
4//=> 2018-10-26
5
6console.log(timestamp.utc());
7//=> 2018-10-26

Customizing the timestamp

You may also pass a string to format the generated timestamp.

1console.log(timestamp('YYYYMMDD'));
2//=> 20181026
3
4console.log(timestamp.utc('YYYYMMDD'));
5//=> 20181026

Supported patterns

• YYYY: full year (ex: 2018)
• MM: month (ex: 04)
• DD: day (ex: 01)
• HH: hours (ex: 12)
• mm: minutes (ex: 59)
• ss: seconds (ex: 09)
• ms: milliseconds (ex: 532)

Usage Examples

1console.log(timestamp('YYYYMMDD'));
2//=> 20181026
3console.log(timestamp.utc('YYYYMMDD'));
4//=> 20181026
5
6console.log(timestamp('YYYYMMDD:ss'));
7//=> 20181026:24
8console.log(timestamp.utc('YYYYMMDD:ss'));
9//=> 20181026:24
10
11console.log(timestamp('YYYY/MM/DD:mm:ss'));
12//=> 2018/10/26:46:24
13console.log(timestamp.utc('YYYY/MM/DD:mm:ss'));
14//=> 2018/10/26:46:24
15
16console.log(timestamp('YYYY:MM:DD'));
17//=> 2018:10:26
18console.log(timestamp.utc('YYYY:MM:DD'));
19//=> 2018:10:26
20
21console.log(timestamp('[YYYY:MM:DD]'));
22//=> [2018:10:26]
23console.log(timestamp.utc('[YYYY:MM:DD]'));
24//=> [2018:10:26]
25
26console.log(timestamp('YYYY/MM/DD'));
27//=> 2018/10/26
28console.log(timestamp.utc('YYYY/MM/DD'));
29//=> 2018/10/26
30
31console.log(timestamp('YYYY:MM'));
32//=> 2018:10
33console.log(timestamp.utc('YYYY:MM'));
34//=> 2018:10
35
36console.log(timestamp('YYYY'));
37//=> 2018
38console.log(timestamp.utc('YYYY'));
39//=> 2018
40
41console.log(timestamp('MM'));
42//=> 10
43console.log(timestamp.utc('MM'));
44//=> 10
45
46console.log(timestamp('DD'));
47//=> 26
48console.log(timestamp.utc('DD'));
49//=> 26
50
51console.log(timestamp('HH'));
52//=> 00
53console.log(timestamp.utc('HH'));
54//=> 04
55
56console.log(timestamp('mm'));
57//=> 46
58console.log(timestamp.utc('mm'));
59//=> 46
60
61console.log(timestamp('ss'));
62//=> 24
63console.log(timestamp.utc('ss'));
64//=> 24
65
66console.log(timestamp('ms'));
67//=> 186
68console.log(timestamp.utc('ms'));
69//=> 186

Release history

v2.0.0

Breaking changes

Default pattern was changed from YYYY:MM:DD to YYYY-MM-DD. See issues/3 for more details.

About

1$ npm install && npm test

1$ npm install -g verbose/verb#dev verb-generate-readme && verb

Related projects

You might also be interested in these projects:

• days: Days of the week. | homepage
• iso-week: Get the ISO week of the year. | homepage
• month: Get the name or number of the current month or any month of the year. | homepage
• months: Months of the year. | homepage
• o-clock: Simple javascript utility for displaying the time in 12-hour clock format. | homepage
• seconds: Get the number of seconds for a minute, hour, day and week. | homepage
• week: Get the current week number. | homepage
• weekday: Get the name and number of the current weekday. Or get the name of the… more | homepage
• year: Simple utility to get the current year with 2 or 4 digits. | homepage

Contributors

Author

Jon Schlinkert

• GitHub Profile
• Twitter Profile
• LinkedIn Profile

License

Copyright © 2018, Jon Schlinkert. Released under the MIT License.

This file was generated by verb-generate-readme, v0.8.0, on October 26, 2018.