https://github.com/caplin/nanotime
JNI library for nanosecond accuracy timestamps in Java 8
https://github.com/caplin/nanotime
Last synced: 5 months ago
JSON representation
JNI library for nanosecond accuracy timestamps in Java 8
- Host: GitHub
- URL: https://github.com/caplin/nanotime
- Owner: caplin
- License: mit
- Created: 2017-09-22T13:18:42.000Z (over 7 years ago)
- Default Branch: develop
- Last Pushed: 2022-05-20T03:43:25.000Z (about 3 years ago)
- Last Synced: 2024-04-14T09:42:14.389Z (about 1 year ago)
- Language: Java
- Size: 181 KB
- Stars: 4
- Watchers: 24
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Caplin nanotime library
JNI library for nanosecond precision timestamps in Java 8.
## Timestamp Accuracy
The accuracy of timestamps can only be as accurate as the timestamps supplied by the operating system.
## Supported Platforms
Nanosecond precision timestamps are supported by the following operating systems:
* Red Hat Enterprise Linux 6
* Red Hat Enterprise Linux 7
* Windows 7
* Windows 10
* Apple macOS 10.12 (Sierra) and higher
* ARM platforms
## Building the project
To build the project, run:
```
./gradlew clean build
```
This will build the C distributable for your platform, and package it up in the jar.
To amalgamate distributables for all supported platforms (Linux, Windows, Arm and Mac), run:
```
buildAllPlatformsJar
```
Note that this will only work within the Caplin domain.
## Publishing
This is a two stage build process. Note that publishing and downloading the platform specific distributables is only available within the Caplin domain.
The first stage is to build the distributable for each supported platform, and publish them to the Caplin artifactory:
```
./gradlew clean publishDistributablePublicationToMavenRepository
```
The second stage is to amalgamate the distributables within a jar, and publish the jar:
```
./gradlew clean publishAllPlatformsJarPublicationToMavenRepository
```
## Usage
```
Clock clock = new NanoClock();
Instant now = clock.instant();
```
## Benchmarks
Benchmarks can be run using:
```
./gradlew clean jmh
```
These are the benchmark results for `NanoClock.instant()` compared to `System.currentTimeMillis()` and `SystemClock.instant()`. Benchmarks were conducted on `Centos 7 64-bit`.
```
Benchmark Method Mode Cnt Score Error Units
NanoClockBenchmark.measureGetNanoClockTime NanoClock.instant() avgt 200 37.287 ± 0.833 ns/op
NanoClockBenchmark.measureGetSystemClockTime SystemClock.instant() avgt 200 39.589 ± 0.927 ns/op
NanoClockBenchmark.measureGetSystemCurrentTime System.currentTimeMillis() avgt 200 30.546 ± 0.430 ns/op
```