Standard library header <ctime>

 

C++

Compiler support

Freestanding and hosted

Language

Standard library

Standard library headers

Named requirements

Feature test macros (C++20)

Language support library

Concepts library (C++20)

Diagnostics library

Memory management library

Metaprogramming library (C++11)

General utilities library

Containers library

Iterators library

Ranges library (C++20)

Algorithms library

Strings library

Text processing library

Numerics library

Date and time library

Input/output library

Filesystem library (C++17)

Concurrency support library (C++11)

Execution control library (C++26)

Technical specifications

Symbols index

External libraries

 

Standard library headers

Language support <cfloat> <climits> <compare> (C++20) <contracts> (C++26) <coroutine> (C++20) <csetjmp> <csignal> <cstdarg> <cstddef> <cstdint> (C++11) <cstdlib> <exception> <initializer_list> (C++11)   <limits> <new> <source_location> (C++20) <stdfloat> (C++23) <typeinfo> <version> (C++20) Concepts <concepts> (C++20) Diagnostics <cassert> <cerrno> <debugging> (C++26) <stacktrace> (C++23) <stdexcept> <system_error> (C++11) Memory management <memory> <memory_resource> (C++17) <scoped_allocator> (C++11) Metaprogramming <meta> (C++26) <ratio> (C++11) <type_traits> (C++11)

General utilities <any> (C++17) <bitset> <bit> (C++20) <charconv> (C++17) <expected> (C++23) <format> (C++20) <functional> <optional> (C++17) <stdbit.h> (C++26) <tuple> (C++11) <typeindex> (C++11) <utility> <variant> (C++17) Containers <array> (C++11) <deque> <flat_map> (C++23) <flat_set> (C++23) <forward_list> (C++11) <hive> (C++26) <inplace_vector> (C++26)   <list> <map> <mdspan> (C++23) <queue> <set> <span> (C++20) <stack> <unordered_map> (C++11) <unordered_set> (C++11) <vector> Iterators <iterator> Ranges <generator> (C++23) <ranges> (C++20)

Algorithms <algorithm> <numeric> Strings <cctype> <cstring> <cuchar> (C++11) <cwchar> <cwctype> <string_view> (C++17) <string> Text processing <clocale> <codecvt> (C++11/17/26*) <locale> <regex> (C++11) <text_encoding> (C++26)   Numerics <cfenv> (C++11) <cmath> <complex> <linalg> (C++26) <numbers> (C++20) <random> (C++11) <simd> (C++26) <stdckdint.h> (C++26) <valarray> Time <chrono> (C++11) <ctime> C compatibility <ccomplex> (C++11/17/20*) <ciso646> (until C++20) <cstdalign> (C++11/17/20*) <cstdbool> (C++11/17/20*) <ctgmath> (C++11/17/20*)

Input/output <cinttypes> (C++11) <cstdio> <filesystem> (C++17) <fstream> <iomanip> <iosfwd> <iostream> <ios> <istream> <ostream> <print> (C++23) <spanstream> (C++23) <sstream> <streambuf> <strstream> (C++98/26*) <syncstream> (C++20) Concurrency support <atomic> (C++11) <barrier> (C++20) <condition_variable> (C++11) <future> (C++11) <hazard_pointer> (C++26) <latch> (C++20) <mutex> (C++11) <rcu> (C++26) <semaphore> (C++20) <shared_mutex> (C++14) <stdatomic.h> (C++23) <stop_token> (C++20) <thread> (C++11) Execution support <execution> (C++17)

 

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

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

Macro constants
CLOCKS_PER_SEC	number of processor clock ticks per second (macro constant)
NULL	implementation-defined null pointer constant (macro constant)
Types
clock_t	process running time (typedef)
size_t	unsigned integer type returned by the sizeof operator (typedef)
time_t	time since epoch type (typedef)
tm	calendar time type (class)
timespec (C++17)	time in seconds and nanoseconds (struct)
Functions
Time manipulation
clock	returns raw processor clock time since the program is started (function)
time	returns the current time of the system as time since epoch (function)
difftime	computes the difference between times (function)
timespec_get (C++17)	returns the calendar time in seconds and nanoseconds based on a given time base (function)
timespec_getres (C++26)	returns the resolution of calendar time based on a given time base (function)
Format conversions
asctime (deprecated in C++26)	converts a std::tm object to a textual representation (function)
ctime (deprecated in C++26)	converts a std::time_t object to a textual representation (function)
strftime	converts a std::tm object to custom textual representation (function)
gmtimegmtime_r (C++26)	converts time since epoch to calendar time expressed as Universal Coordinated Time (function)
localtimelocaltime_r (C++26)	converts time since epoch to calendar time expressed as local time (function)
mktime	converts calendar time to time since epoch (function)
timegm (C++26)	converts calendar time to time since epoch, ignoring the Daylight Saving Time flag (function)

Synopsis

#define __STDC_VERSION_TIME_H__ 202311L

#define NULL               /* see description */
#define CLOCKS_PER_SEC     /* see description */
#define TIME_UTC           /* see description */
#define TIME_MONOTONIC     /* see description */ // optional
#define TIME_ACTIVE        /* see description */ // optional
#define TIME_THREAD_ACTIVE /* see description */ // optional

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 timegm(tm* timeptr);
  time_t time(time_t* timer);
  int timespec_get(timespec* ts, int base);
  int timespec_getres(timespec* ts, int base);
  char* asctime(const tm* timeptr);
  char* ctime(const time_t* timer);
  tm* gmtime(const time_t* timer);
  tm* gmtime_r(const time_t* timer, tm* buf);
  tm* localtime(const time_t* timer);
  tm* localtime_r(const time_t* timer, tm* buf);
  size_t strftime(char* s, size_t maxsize, const char* format, const tm* timeptr);
}

Class std::timespec

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

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;
};