last-seen-ago

last-seen-ago is a zero-dependency module that highly customizable real time to last seen like Facebook,Twitter,Instagram...

It is a simple one line code ,Its automatically converts to given timestamp in the right units like seconds, minutes, hours, days,weeks, years using getLastSeen() method.

Examples:

• Juts Now
• 45 seconds
• one minute ago
• 15 minutes ago
• an hour ago
• 2 hrs ago
• yesterday
• 2 days ago
• a week ago
• 2 weeks ago
• …

Installation

npm install last-seen-ago --save

Usage

As early as possible in your application, require and configure last seen.Check it following Rules.

getLastSeen()

//require last-seen-ago module
const lastSeenAgo = require("last-seen-ago");
 
//for example your real time timestamp 1602050284
const realTime = 1602050284;
 
//get exact last seen according to time
const lastSeen = lastSeenAgo.getLastSeen(realTime)
 
//print output will be "34 minutes ago"
console.log(lastSeen)

Rules

The parsing timstamp support the following rules:

• To timestamp value should be double data type.
• To get the timestamp as seconds. For example
  • To get the timestamp Date.now() method can be called.
  • Note that this method returns the timestamp in milliseconds.
  • To get the timestamp as seconds we can divide it by 1000.

Given are the following formats:

• Format type 1 with backslashes (/) as the separator characters.
• Format type 2 with dashes (-) as the separator characters.
• Format type 3 with dots (.) as the separator characters.
• Format type 4 with spaces ( ) as the separator characters.

Type	Example
YYYY-MM-DD or yyyy-mm-dd	2020-10-12
YYYY-DD-MM or YYYY-DD-MM	2020-12-10
MM-DD-YYYY or mm-dd-yyyy	10-12-2020
DD-MM-YYYY or DD-MM-YYYY	12-10-2020
YYYY-MM-DD HH:MM:SS or yyyy-mm-dd hh:mm:ss	2020-10-12 11:26:1
YYYY-DD-MM HH:MM:SS or YYYY-DD-MM hh:mm:ss	2020-12-10 11:26:1
MM-DD-YYYY HH:MM:SS or mm-dd-yyyy hh:mm:ss	10-12-2020 11:26:1
DD-MM-YYYY HH:MM:SS or DD-MM-YYYY hh:mm:ss	12-10-2020 11:26:1
YYYY.MM.DD or yyyy.mm.dd	2020.10.12
YYYY.DD.MM or YYYY.DD.MM	2020.12.10
MM.DD.YYYY or mm.dd.yyyy	10.12.2020
DD.MM.YYYY or DD.MM.YYYY	12.10.2020
YYYY.MM.DD HH:MM:SS or yyyy.mm.dd hh:mm:ss	2020.10.12 11:26:1
YYYY.DD.MM HH:MM:SS or YYYY.DD.MM hh:mm:ss	2020.12.10 11:26:1
MM.DD.YYYY HH:MM:SS or mm.dd.yyyy hh:mm:ss	10.12.2020 11:26:1
DD.MM.YYYY HH:MM:SS or DD.MM.YYYY hh:mm:ss	12.10.2020 11:26:1
YYYY/MM/DD or yyyy/mm/dd	2020/10/12
YYYY/DD/MM or YYYY/DD/MM	2020/12/10
MM/DD/YYYY or mm/dd/yyyy	10/12/2020
DD/MM/YYYY or DD/MM/YYYY	12/10/2020
YYYY/MM/DD HH:MM:SS or yyyy/mm/dd hh:mm:ss	2020/10/12 11:26:1
YYYY/DD/MM HH:MM:SS or YYYY/DD/MM hh:mm:ss	2020/12/10 11:26:1
MM/DD/YYYY HH:MM:SS or mm/dd/yyyy hh:mm:ss	10/12/2020 11:26:1
DD/MM/YYYY HH:MM:SS or DD/MM/YYYY hh:mm:ss	12/10/2020 11:26:1
YYYY MM DD or yyyy mm dd	2020 10 12
YYYY DD MM or YYYY DD MM	2020 12 10
MM DD YYYY or mm dd yyyy	10 12 2020
DD MM YYYY or DD MM YYYY	12 10 2020
YYYY MM DD HH:MM:SS or yyyy mm dd hh:mm:ss	2020 10 12 11:26:1
YYYY DD MM HH:MM:SS or YYYY DD MM hh:mm:ss	2020 12 10 11:26:1
MM DD YYYY HH:MM:SS or mm dd yyyy hh:mm:ss	10 12 2020 11:26:1
DD MM YYYY HH:MM:SS or DD MM YYYY hh:mm:ss	12 10 2020 11:26:1

Some Short formats

Type	Example
Y/m/d H:m:s	2020/10/12 11:26:1
Y/d/m H:m:s	2020/12/10 11:26:1
m/d/Y H:m:s	10/12/2020 11:26:1
d/m/Y H:m:s	12/10/2020 11:26:1
Y-m-d H:m:s	2020-10-12 11:26:1
Y-d-m H:m:s	2020-12-10 11:26:1
m-d-Y H:m:s	10-12-2020 11:26:1
d-m-Y H:m:s	12-10-2020 11:26:1
Y.m.d H:m:s	2020.10.12 11:26:1
Y.d.m H:m:s	2020.12.10 11:26:1
m.d.Y H:m:s	10.12.2020 11:26:1
d.m.Y H:m:s	12.10.2020 11:26:1

getFormat()

//require last-seen-ago module
const lastSeenAgo = require("last-seen-ago");
 
//if timestamp in 1602495292171(miliseconds),then converts timestamp in seconds divide it by 1000.
const realTime = 1602495292171;
 
//if timestamp in 1602495292 (seconds).
const realTime = 1602495292;
 
//get exact last seen according to timestmap and specific format.
const lastSeen = lastSeenAgo.getFormat(realTime,'YYYY-MM-DD')
 
//print output will be 2020-12-10"
console.log(lastSeen)

Future Plan

More features added soon like.

License

MIT