# zx_clock_get_monotonic

## Summary

Acquire the current monotonic time.

## Declaration

    #include <zircon/syscalls.h>

    zx_instant_mono_t zx_clock_get_monotonic(void);

## Description

`zx_clock_get_monotonic()` returns the current time in the system
monotonic clock. This is the number of nanoseconds since the system was
powered on, not including any time spent in a suspended state. It is
set to zero whenever the kernel is initialized.

## Rights

None.

## Return value

`zx_clock_get_monotonic()` returns the current monotonic time.

## Errors

`zx_clock_get_monotonic()` cannot fail.