What is time-stamp?
The time-stamp npm package is designed to create formatted timestamps. It allows users to generate timestamps based on the current date and time in a customizable format. This can be particularly useful for logging, file naming, or any other scenario where time-based identifiers are needed.
What are time-stamp's main functionalities?
Generating current date in default format
By default, time-stamp can generate the current date in the 'YYYY/MM/DD' format. This is useful for quickly obtaining a standardized date format without any configuration.
"YYYY/MM/DD"
Custom formatting of date and time
time-stamp allows for custom formatting of the date and time, enabling users to specify the exact format they need. This feature supports a wide range of tokens for years, months, days, hours, minutes, seconds, and milliseconds.
"YYYY:MM:DD HH:mm:ss.ms"
Other packages similar to time-stamp
moment
Moment.js is a comprehensive date handling library that allows for parsing, validating, manipulating, and formatting dates. Compared to time-stamp, Moment.js offers a broader set of functionalities for dealing with dates and times, including support for time zones and localization.
date-fns
date-fns provides a collection of simple, pure functions for performing various operations on dates. It's modular, allowing users to pick and choose which functions they need. While time-stamp focuses on generating timestamps, date-fns offers more general-purpose date manipulation and formatting capabilities.
dayjs
Day.js is a lightweight date library that offers a similar API to Moment.js. It's designed to be immutable and chainable, making it easy to parse, validate, manipulate, and display dates and times. Compared to time-stamp, Day.js provides a more comprehensive solution for date handling while maintaining a small footprint.
time-stamp
Get a formatted timestamp.
Install
Install with npm:
$ npm install --save time-stamp
v2.0.0
Breaking changes
Default pattern was changed from YYYY:MM:DD
to YYYY-MM-DD
. See https://github.com/jonschlinkert/time-stamp/issues/3 for more details.
Usage
var timestamp = require('time-stamp');
timestamp();
timestamp('YYYYMMDD');
timestamp('YYYYMMDD:ss');
timestamp('YYYY/MM/DD:mm:ss');
timestamp('YYYY:MM:DD');
timestamp('[YYYY:MM:DD]');
timestamp('YYYY/MM/DD');
timestamp('YYYY:MM');
timestamp('YYYY');
timestamp('MM');
timestamp('DD');
timestamp('HH');
timestamp('mm');
timestamp('ss');
timestamp('ms');
Valid patterns
YYYY
: full year (ex: 2017)MM
: month (ex: 04)DD
: day (ex: 01)HH
: hours (ex: 12)mm
: minutes (ex: 59)ss
: seconds (ex: 09)ms
: milliseconds (ex: 532)
About
Related projects
Contributing
Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.
Contributors
Building docs
(This project's readme.md is generated by verb, please don't edit the readme directly. Any changes to the readme must be made in the .verb.md readme template.)
To generate the readme, run the following command:
$ npm install -g verbose/verb
Running tests
Running and reviewing unit tests is a great way to get familiarized with a library and its API. You can install dependencies and run tests with the following command:
$ npm install && npm test
Author
Jon Schlinkert
License
Copyright © 2017, Jon Schlinkert.
Released under the MIT License.
This file was generated by verb-generate-readme, v0.6.0, on May 14, 2017.