Section 3 · Library functions

timespec.3type

Package: man-pages

timespec

NAME
LIBRARY
SYNOPSIS
DESCRIPTION
VERSIONS
STANDARDS
HISTORY
NOTES
SEE ALSO

NAME

timespec − time in seconds and nanoseconds

LIBRARY

Standard C library (libc)

SYNOPSIS

#include <time.h>

struct timespec {
time_t tv_sec; /* Seconds */
/* … */ tv_nsec; /* Nanoseconds [0, 999’999’999] */ **
};**

DESCRIPTION

Describes times in seconds and nanoseconds.

tv_nsec is of an implementation-defined signed type capable of holding the specified range. Under glibc, this is usually long, and long long on X32. It can be safely down-cast to any concrete 32-bit integer type for processing.

VERSIONS

Prior to C23, tv_nsec was long.

STANDARDS

C11, POSIX.1-2008.

HISTORY

POSIX.1-2001.

NOTES

The following headers also provide this type: <aio.h>, <mqueue.h>, <sched.h>, <signal.h>, <sys/select.h>, and <sys/stat.h>.