/ 
Time-Nanos-v0.1.4
/ Time::Nanos

NAME

Time::Nanos - Nanosecond time resolution via clock_gettime().

SYNOPSIS

use Time::Nanos;

my $nanoseconds  = nanos();
my $microseconds = micros();
my $milliseconds = millis();

my ($seconds, $nanoseconds) = nanos(1);

VARIABLES

$CLOCK

$Time::Nanos::CLOCK = 'realtime';

Controls which clock source the functions use. Defaults to 'realtime'. Valid values: 'monotonic' or 'realtime'.

FUNCTIONS

nanos()

my $ns = nanos();
my ($sec, $nsec) = nanos(1);

Returns nanoseconds. In scalar context returns total nanoseconds. With a true argument returns a list of (seconds, nanoseconds) instead.

micros()

my $us = micros();
my ($sec, $usec) = micros(1);

Returns microseconds as an integer. In scalar context returns total microseconds. With a true argument returns a list of (seconds, microseconds) instead.

millis()

my $ms = millis();
my ($sec, $msec) = millis(1);

Returns milliseconds as an integer. In scalar context returns total milliseconds. With a true argument returns a list of (seconds, milliseconds) instead.

DESCRIPTION

This module provides high-resolution time via clock_gettime(). The default clock is CLOCK_REALTIME. 'realtime' uses the system clock, which measures time since the Unix epoch. This is susceptible to clock skew from NTP updates, user clock changes, etc. When using 'realtime', it is possible (but rare) to observe a negative duration when comparing two successive calls.

When using 'monotonic' the clock reference epoch is unspecified, so a single reading is not in itself a useful measurement of time. These values are only meaningful when compared against each other to measure elapsed time.