std::time

From cppreference.com
< cpp‎ | chrono‎ | c
C++
Date and time library
Time point
(C++11)
(C++20)
Duration
(C++11)
Clocks
(C++11)
(C++11)
(C++20)
(C++20)
(C++20)
(C++11)
(C++20)
(C++20)
(C++20)
Time of day
(C++20)(C++20)
(C++20)(C++20)
(C++20)

Calendar
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)(C++20)
Time zone
(C++20)
(C++20)
(C++20) (C++20) (C++20) (C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
chrono I/O
(C++20)
C-style date and time
C-style date and time utilities
Functions
Time manipulation
time
(C++17)
Format conversions
Constants
Types
(C++17)
Defined in header <ctime>
std::time_t time( std::time_t * arg ) ;

Returns the current calendar time encoded as a std::time_t object, and also stores it in the object pointed to by arg, unless arg

Parameters

arg - pointer to a std::time_t object to store the time, or a null pointer

Return value

Current calendar time encoded as std::time_t object on success, ( std::time_t ) ( - 1 ) on error. If arg is not null, the return value is also stored in the object pointed to by arg

Notes

The encoding of calendar time in std::time_t is unspecified, but most systems conform to the POSIX specification and return a value of integral type holding 86400 times the number of calendar days since the Epoch S.I. seconds std::time_t is a 32-bit signed integer (many historical implementations) fail in the year 2038

Example

Run this code
#include <ctime>
#include <iostream>
 
int main()
{
    std::time_t result = std::time(nullptr);
    std::cout << std::asctime(std::localtime(&result))
              << result << " seconds since the Epoch\n";
}

Possible output: 

Wed Sep 21 10:27:52 2011
1316615272 seconds since the Epoch

See also

(C++17)
 returns the calendar time in seconds and nanoseconds based on a given time base
(function)
converts time since epoch to calendar time expressed as local time
(function)
converts time since epoch to calendar time expressed as Universal Coordinated Time
(function)
(C++11)
 wall clock time from the system-wide realtime clock
(class)
C documentation for time
Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/chrono/c/time&oldid=180262