microseconds

What is microseconds?

The `microseconds` npm package provides high-resolution timing functions that allow you to measure and work with time intervals with microsecond precision. This can be particularly useful for performance testing, benchmarking, or any scenario where precise timing is crucial.

What are microseconds's main functionalities?

Current time in microseconds

This feature allows you to get the current time in microseconds since the Unix epoch. It's useful for timestamping events with high precision.

const microseconds = require('microseconds');
const now = microseconds.now();

Microsecond difference

By capturing the time before and after an operation, you can calculate the operation's duration in microseconds. This is particularly useful for performance testing or optimization.

const start = microseconds.now();
// Some operation
cost end = microseconds.now();
const diff = end - start;

Other packages similar to microseconds

nanotimer

Similar to `microseconds`, `nanotimer` offers high-resolution timers but focuses on nanosecond precision. It provides a different level of granularity and includes functionality for timeouts and intervals, which `microseconds` does not.

performance-now

This package provides a function to get a timestamp with sub-millisecond precision, similar to `microseconds`. However, `performance-now` is more focused on compatibility with the performance.now() Web API, making it more suitable for cross-environment timing (Node.js and browsers).

README

μs

Generate and parse microseconds.

Uses hrtime in node.js, performance.now in browsers. Falls back to Date.now() * 1000.

API

const μs = require('microseconds')

now

timestamp in microseconds

const now = μs.now()
// 1404398280599786

parse

as an object

const parsed = μs.parse(now)
// { microseconds: 786, milliseconds: 599, seconds: 0, minutes: 38, hours: 14, days: 16254 }

as a string

parsed.toString()
// "16254 days 14 hours 38 minutes 0 seconds 599 milliseconds 786 microseconds"

μs.parse(1000).toString()
// "1 millisecond"

μs.parse(1).toString()
// "1 microsecond"

μs.parse(4231002).toString()
// "4 seconds 231 milliseconds 2 microseconds"

since

const before = μs.now()
const time = μs.since(before) // time passed