Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master
Fetching contributors…

Cannot retrieve contributors at this time

32 lines (24 sloc) 1.232 kb

Fancy Timestamp

Use this to create natural language for your unix timestamps (similar to Facebook's)

Plays well with browserify


Install with NPM and require where needed.

npm install fancy-timestamp
var fancyTimestamp = require('fancy-timestamp');

Fancy Timestamp can accept normal timestamps composed of seconds.

var normalTimestamp = 1342123755; //Using only seconds

var fancyTimestampString = fancyTimestamp(normalTimestamp); // result == "8 minutes ago"

It can also accept timestamps composed of milliseconds such as the ones JavaScript defaults to. To parse millisecond timestamps pass a second parameter of 'true'.

var javascriptTimestamp = (new Date()).getTime(); //Using JavaScript's timestamp composed of milliseconds

fancyTimestampString = fancyTimestamp(javascriptTimestamp, true); // result == "Just now"

Where appropriate, fancy-timestamp will apply the appropriate ending to the natural language text such as 'tomorrow' or 'away' for dates in the future, and 'yesterday' or 'ago' for dates in the past.


MIT license

Jump to Line
Something went wrong with that request. Please try again.