Skip to content

Search topics & cppreference

Search all study topics, concept maps, and 6,587 C++ and C reference pages.

time_t

Real arithmetic type capable of representing times.

NotebookLM
Defined in header <time.h>
typedef /* unspecified */ time_t;

Real arithmetic type capable of representing times.

Although not defined by the C standard, this is almost always an integral value holding the number of seconds (not counting leap seconds) since 00:00, Jan 1 1970 UTC, corresponding to POSIX time.

Notes

The standard uses the term calendar time when referring to a value of type time_t.

Example

Show the start of the epoch.

snippet.c
#include <stdio.h>
#include <time.h>
#include <stdint.h>
 
int main(void)
{
    time_t epoch = 0;
    printf("%jd seconds since the epoch began\n", (intmax_t)epoch);
    printf("%s", asctime(gmtime(&epoch)));
}
Possible output
0 seconds since the epoch began
Thu Jan  1 00:00:00 1970

References

  • C17 standard (ISO/IEC 9899:2018):
  • 7.27.1/3 Components of time (p: 284)
  • C11 standard (ISO/IEC 9899:2011):
  • 7.27.1/3 Components of time (p: 388)
  • C99 standard (ISO/IEC 9899:1999):
  • 7.23.1/3 Components of time (p: 338)
  • C89/C90 standard (ISO/IEC 9899:1990):
  • 4.12.1 Components of time

See also

returns the current calendar time of the system as time since epoch
(function)
converts time since epoch to calendar time expressed as local time
(function)
converts time since epoch to calendar time expressed as Coordinated Universal Time (UTC)
(function)

Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.