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  ex-
       pressed	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  success-
       ful, 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").

HISTORY
       This interface first appeared in	FreeBSD	12.

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

FreeBSD	14.3			August 21, 2023		       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+14.3-RELEASE+and+Ports>

home | help