Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
TIMESPEC_GET(3) 	     Library Functions Manual		 TIMESPEC_GET(3)

NAME
     timespec_get -- get current calendar time

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <time.h>

     int
     timespec_get(struct timespec *ts, int base);

DESCRIPTION
     The  timespec_get	function  sets the interval pointed to by ts to hold the
     current calendar time based on the specified time base in base.

     The base TIME_UTC returns the time since the epoch.  This time is expressed
     in seconds and nanoseconds since midnight (0 hour), January  1,  1970.   In
     FreeBSD, this corresponds to CLOCK_REALTIME.

     The  base	TIME_MONOTONIC	returns a monotonically-increasing time since an
     unspecified  point  in  the  past.   In  FreeBSD,	 this	corresponds   to
     CLOCK_MONOTONIC.

RETURN VALUES
     The  timespec_get	function returns the passed value of base if successful,
     otherwise 0 on failure.

SEE ALSO
     clock_gettime(2), gettimeofday(2), time(3), timespec_getres(3)

STANDARDS
     The timespec_get function with a  base  of  TIME_UTC  conforms  to  ISO/IEC
     9899:2011	("ISO  C11").	The  TIME_MONOTONIC  base  conforms  to  ISO/IEC
     9899:2024 ("ISO C23").

HISTORY
     This interface first appeared in FreeBSD 12.

AUTHORS
     Kamil Rytarowski <kamil@NetBSD.org>
     Warner Losh <imp@FreeBSD.org>

FreeBSD ports 15.quarterly	  May 14, 2026			 TIMESPEC_GET(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=timespec_get&sektion=3&manpath=FreeBSD+15.1-RELEASE+and+Ports.quarterly>

home | help