Node.js Unique, time sortable IDs for your objects
Switch branches/tags
Nothing to show
Clone or download
Latest commit ae1b0e5 Feb 11, 2015
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib update module name Oct 3, 2013
test update module name Oct 3, 2013
.gitignore added travis support Feb 12, 2015
.travis.yml added travis support Feb 12, 2015
LICENSE Initial commit Oct 3, 2013
Makefile initial import Oct 3, 2013 correct ID length typo Feb 12, 2015
index.js initial import Oct 3, 2013
package.json update version Feb 12, 2015


Node module to generate globally unique, time sortable indentifiers that can be used as database unique IDs. The identifiers are time sortable and you can recover the time stamp of when they were created down to micro-second resolution. Time sortable identifiers can very useful in situations where you want to sort your objects by time, for instance messages in a user's inbox.

This module generates 15 byte IDs with the following format:

  • 32 bit time
  • 24 bit micro time
  • 24 bit machine id
  • 16 bit pid
  • 24 bit increment

Please note that the generated IDs are not standard UUID, or GUID.


Simple installation with NPM

npm install node-time-uuid


var ObjectId = require("node-time-uuid");

var id = new ObjectId();

// get date from Id
var date = id.getDate();

// get timestamp from Id
var timestamp =  id.getTimestamp();

// get timestamp and microsecond time
var [timestamp, microseconds] = id.getTimeOfDay();


New Instance

ObjectId can be instanciated in several different ways:

var ObjectId = require("node-time-uuid");

// Create a new ID
var id = new ObjectId();

// Create an Object Id instance from existing Id encoded as a Hex string
var id = new ObjectId("512055ac09b8979d8fa1511f000002");

// Create an Object Id instance from existing Id encoded as base64 string
var id = new ObjectId("USBVrAm4l52PoVEfAAAC");

// Create an Object Id instance from existing Node buffer
var id = new ObjectId(buffer);

Supported encodings are hex, base64 and base64url


Returns a 15 byte Node.js Buffer object with the Id.

var buffer = id.get();


Returns a string representation of ObjectId, according to the specified enconding. Supported encodings are hex, base64, base64url, pretty.

  • hex: 512055ac09b8979d8fa1511f000002
  • base64: USBVrAm4l52PoVEfAAAC
  • base64url: USBVrAm4l52PoVEfAAA-
  • pretty: 512055ac-09b897-9d8fa1-511f-000002


Get the unix timestamp from the ObjectId

var timestamp =  id.getTimestamp();


Get timestamp of the ObjectId in seconds and microseconds

var [timestamp, microseconds] = id.getTimeOfDay();


Return Javascript Date() object from the ObjectId.


Tests require Node mocha and istanbul modules to be installed .

npm install mocha istanbul -g

To run all module tests simply run:

npm test


make test

To obtain a test coverage report run

npm cover

Then open ./html-report/index.html in your browser


MIT License