Namespaces
Variants
Views
Actions

Standard library header <ctime>

From cppreference.com
< cpp‎ | header
 
 
Standard Library headers
Note: a slash '/' in a revision mark means that the header was deprecated and/or removed.
Language support
Concepts
<concepts> (C++20)
Diagnostics
<system_error> (C++11)

Memory management
<memory_resource> (C++17)  
Metaprogramming
<type_traits> (C++11)
<ratio> (C++11)
General utilities
<utility>
<tuple> (C++11)
<optional> (C++17)
<variant> (C++17)
<any> (C++17)
<expected> (C++23)
<bitset>

<charconv> (C++17)
<format> (C++20)
<bit> (C++20)

Strings
<cuchar> (C++11)

Containers
<flat_set> (C++23)
<span> (C++20)
<mdspan> (C++23)

Iterators
<iterator>
Ranges
<ranges> (C++20)
<generator> (C++23)
Algorithms
Numerics
<cfenv> (C++11)
<complex>
<numbers> (C++20)

Time
<chrono> (C++11)
<ctime>
Localization
<codecvt> (C++11/17)
Input/output
<filesystem> (C++17)
<cstdio>
<cinttypes> (C++11)
<strstream> (C++98/)
Regular expressions
<regex> (C++11)
Concurrency support
<stop_token> (C++20)
<thread> (C++11)
<atomic> (C++11)
<stdatomic.h> (C++23)
<mutex> (C++11)
<shared_mutex> (C++14)
<condition_variable> (C++11)  
<semaphore> (C++20)
<latch> (C++20)
<barrier> (C++20)
<future> (C++11)

C compatibility
<cstdbool> (C++11/17/20)  
<ccomplex> (C++11/17/20)
<ctgmath> (C++11/17/20)

<cstdalign> (C++11/17/20)

<ciso646> (until C++20)

 

This header was originally in the C standard library as <time.h>.

This header is part of the C-style date and time library.

Contents

Macro constants

number of processor clock ticks per second
(macro constant) [edit]
implementation-defined null pointer constant
(macro constant) [edit]

Types

process running time
(typedef) [edit]
unsigned integer type returned by the sizeof operator
(typedef) [edit]
time since epoch type
(typedef) [edit]
calendar time type
(class) [edit]
(C++17)
time in seconds and nanoseconds
(struct) [edit]

Functions

Time manipulation
returns raw processor clock time since the program is started
(function) [edit]
returns the current time of the system as time since epoch
(function) [edit]
computes the difference between times
(function) [edit]
returns the calendar time in seconds and nanoseconds based on a given time base
(function) [edit]
Format conversions
converts a std::time_t object to a textual representation
(function) [edit]
converts a std::tm object to a textual representation
(function) [edit]
converts a std::tm object to custom textual representation
(function) [edit]
converts a std::tm object to custom wide string textual representation
(function) [edit]
converts time since epoch to calendar time expressed as Universal Coordinated Time
(function) [edit]
converts time since epoch to calendar time expressed as local time
(function) [edit]
converts calendar time to time since epoch
(function) [edit]

[edit] Synopsis

#define NULL /* see description */
#define CLOCKS_PER_SEC /* see description */
#define TIME_UTC /* see description */
 
namespace std {
  using size_t = /* see description */;
  using clock_t = /* see description */;
  using time_t = /* see description */;
 
  struct timespec;
  struct tm;
 
  clock_t clock();
  double difftime(time_t time1, time_t time0);
  time_t mktime(tm* timeptr);
  time_t time(time_t* timer);
  int timespec_get(timespec* ts, int base);
  char* asctime(const tm* timeptr);
  char* ctime(const time_t* timer);
  tm* gmtime(const time_t* timer);
  tm* localtime(const time_t* timer);
  size_t strftime(char* s, size_t maxsize, const char* format, const tm* timeptr);
}

[edit] Class std::timespec

struct timespec {
  std::time_t tv_sec;
  long tv_nsec;
};

[edit] Class std::tm

struct tm {
  int tm_sec;
  int tm_min;
  int tm_hour;
  int tm_mday;
  int tm_mon;
  int tm_year;
  int tm_wday;
  int tm_yday;
  int tm_isdst;
};