timestamp-plus

Get a formatted timestamp.

• Install
• Usage
• Customizing the timestamp
• importance

Install

Install with npm:

$ npm install --save timestamp-plus

Usage

const timestamp = require('timestamp-plus');

console.log(timestamp());
//=> 2023-10-26

console.log(timestamp.utc());
//=> 2023-10-26

console.log(timestamp(1698308059000));
//=> 2023-10-26

console.log(timestamp.utc(1698308059000));
//=> 2023-10-26

Customizing the timestamp

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

console.log(timestamp('YYYYMMDD'));
//=> 20231026

console.log(timestamp.utc('YYYYMMDD'));
//=> 20231026

Supported patterns

• YYYY|yyyy: full year (ex: 2023)
• YY|yy: full year (ex: 23)
• MM|mm: month (ex: 10)
• DD|dd: day (ex: 26)
• h|H: hours (ex: 12)
• m|M: minutes (ex: 59)
• s|S: seconds (ex: 09)
• ms: milliseconds (ex: 532)

Usage Examples

console.log(timestamp('YYYYMMDD'));
//=> 20231026
console.log(timestamp.utc('YYYYMMDD'));
//=> 20231026

console.log(timestamp('yyyy年mm月dd日'));
//=> 2023年10月26日
console.log(timestamp.utc('yyyy年mm月dd日'));
//=> 2023年10月26日

console.log(timestamp('yyyy-mm-dd',1698308059000));
//=> 2023-10-26
console.log(timestamp('yy/mm/dd',1698308059000));
//=> 23/10/26
console.log(timestamp('yyyy年mm月dd日',1698308059000));
//=> 2023年10月26日

console.log(timestamp('YYYY:MM:DD'));
//=> 2023:10:26
console.log(timestamp.utc('YYYY:MM:DD'));
//=> 2023:10:26

console.log(timestamp('[YYYY:MM:DD]'));
//=> [2023:10:26]
console.log(timestamp.utc('[YYYY:MM:DD]'));
//=> [2023:10:26]

console.log(timestamp('YYYY/MM/DD'));
//=> 2023/10/26
console.log(timestamp.utc('YYYY/MM/DD'));
//=> 2023/10/26

console.log(timestamp('YYYY:MM'));
//=> 2023:10
console.log(timestamp.utc('YYYY:MM'));
//=> 2023:10

console.log(timestamp('YYYY'));
//=> 2023
console.log(timestamp.utc('YYYY'));
//=> 2023

console.log(timestamp('MM'));
//=> 10
console.log(timestamp.utc('MM'));
//=> 10

console.log(timestamp('DD'));
//=> 26
console.log(timestamp.utc('DD'));
//=> 26

console.log(timestamp('H'));
//=> 00
console.log(timestamp.utc('H'));
//=> 04

console.log(timestamp('m'));
//=> 46
console.log(timestamp.utc('m'));
//=> 46

console.log(timestamp('s'));
//=> 24
console.log(timestamp.utc('s'));
//=> 24

console.log(timestamp('ms'));
//=> 186
console.log(timestamp.utc('ms'));
//=> 186

importance

当时间戳在一天之内,时间戳会加上一个辅助时间来更好得到时分秒毫秒。
When the timestamp is within a day, a supplementary time is added to the timestamp to better obtain the time seconds and milliseconds

 date = Date.parse(new Date("2021/7/11 0:0:0")) + date;

Usage Examples

console.log(timestamp('m:s',1000))
// => 00:01
console.log(timestamp('h:m:s',1000))
// => 00:00:01
console.log(timestamp('m/s',1000))
// => 00/01
console.log(timestamp('ms',1000))
// => 000 ??? why???
// 因为会优先匹配ms,而不是m,s
// Because it matches ms first, not m, not s