1 files changed, 43 insertions, 0 deletions
diff --git a/docs/reference/src/api/nng_clock.md b/docs/reference/src/api/nng_clock.md
new file mode 100644
index 00000000..37be0d0c
--- /dev/null
+++ b/docs/reference/src/api/nng_clock.md
@@ -0,0 +1,43 @@
+# nng_clock()
+
+## NAME
+
+nng_clock - get time
+
+## SYNOPSIS
+
+```c
+#include <nng/nng.h>
+#include <nng/supplemental/util/platform.h>
+
+typedef uint64_t nng_time;
+
+nng_time nng_clock(void);
+```
+
+## DESCRIPTION
+
+The `nng_clock()` function returns the number of elapsed milliseconds since some
+arbitrary time in the past.
+The resolution of the clock depends on the underlying timing facilities
+of the system.
+This function may be used for timing, but applications should not expect
+very fine-grained values.
+
+> [!NOTE]
+> The reference time will be the same for a given program,
+> but different programs may have different references.
+
+This function is intended to help with setting appropriate
+timeouts using [`nng_cv_until()`](nng_cv_until.md).
+
+## RETURN VALUES
+
+Milliseconds since reference time.
+
+## SEE ALSO
+
+[nng_sleep_aio()](nng_sleep_aio.md),
+[nng_cv_until()](nng_cv_until.md),
+[nng_msleep()](nng_msleep.md),
+[nng_duration](nng_duration.md)