https://github.com/ehmicky/time-resolution

Find the process's time resolution
https://github.com/ehmicky/time-resolution

browsers date date-now hrtime javascript library microseconds milliseconds nanosecond-resolution nanoseconds nodejs performance performance-analysis performance-metrics performance-monitoring performance-testing performance-tuning resolution seconds typescript

Last synced: about 1 month ago
JSON representation

Find the process's time resolution

• Host: GitHub
• URL: https://github.com/ehmicky/time-resolution
• Owner: ehmicky
• License: mit
• Created: 2019-08-30T17:35:04.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2025-03-13T05:04:08.000Z (about 1 month ago)
• Last Synced: 2025-03-13T06:19:08.770Z (about 1 month ago)
• Topics: browsers, date, date-now, hrtime, javascript, library, microseconds, milliseconds, nanosecond-resolution, nanoseconds, nodejs, performance, performance-analysis, performance-metrics, performance-monitoring, performance-testing, performance-tuning, resolution, seconds, typescript
• Language: TypeScript
• Homepage:
• Size: 6.46 MB
• Stars: 2
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
[![Node](https://img.shields.io/badge/-Node.js-808080?logo=node.js&colorA=404040&logoColor=66cc33)](https://www.npmjs.com/package/time-resolution)

[![Browsers](https://img.shields.io/badge/-Browsers-808080?logo=firefox&colorA=404040)](https://unpkg.com/time-resolution?module)

[![TypeScript](https://img.shields.io/badge/-Typed-808080?logo=typescript&colorA=404040&logoColor=0096ff)](/src/main.ts)

[![Codecov](https://img.shields.io/badge/-Tested%20100%25-808080?logo=codecov&colorA=404040)](https://codecov.io/gh/ehmicky/time-resolution)

[![Minified size](https://img.shields.io/bundlephobia/minzip/time-resolution?label&colorA=404040&colorB=808080&logo=webpack)](https://bundlephobia.com/package/time-resolution)

[![Mastodon](https://img.shields.io/badge/-Mastodon-808080.svg?logo=mastodon&colorA=404040&logoColor=9590F9)](https://fosstodon.org/@ehmicky)

[![Medium](https://img.shields.io/badge/-Medium-808080.svg?logo=medium&colorA=404040)](https://medium.com/@ehmicky)

Find the process's time resolution.

The time resolution is a combination of multiple software and hardware factors.

This finds it by creating many timestamps in a row and computing their common

denominator.

# Hire me

Please

[reach out](https://www.linkedin.com/feed/update/urn:li:activity:7117265228068716545/)

if you're looking for a Node.js API or CLI engineer (11 years of experience).

Most recently I have been [Netlify Build](https://github.com/netlify/build)'s

and [Netlify Plugins](https://www.netlify.com/products/build/plugins/)'

technical lead for 2.5 years. I am available for full-time remote positions.

# Example

```js

import timeResolution from 'time-resolution'

const resolution = timeResolution()

```

# Install

```bash

npm install time-resolution

```

This package works in both Node.js >=18.18.0 and

[browsers](https://raw.githubusercontent.com/ehmicky/dev-tasks/main/src/browserslist).

This is an ES module. It must be loaded using

[an `import` or `import()` statement](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c),

not `require()`. If TypeScript is used, it must be configured to

[output ES modules](https://www.typescriptlang.org/docs/handbook/esm-node.html),

not CommonJS.

# API

## timeResolution()

_Return value_: `number`

Returns the system's time resolution, in nanoseconds.

# Related projects

- [`precise-now`](https://github.com/ehmicky/precise-now): Like

  `performance.now()` but in nanoseconds

# Support

For any question, _don't hesitate_ to [submit an issue on GitHub](../../issues).

Everyone is welcome regardless of personal background. We enforce a

[Code of conduct](CODE_OF_CONDUCT.md) in order to promote a positive and

inclusive environment.

# Contributing

This project was made with ❤️. The simplest way to give back is by starring and

sharing it online.

If the documentation is unclear or has a typo, please click on the page's `Edit`

button (pencil icon) and suggest a correction.

If you would like to help us fix a bug or add a new feature, please check our

[guidelines](CONTRIBUTING.md). Pull requests are welcome!