std::time
From Cppreference
C++ Standard Library | ||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Utilities library | ||||||||||||||||||||||||||||||||||||||||
Date and time utilities | ||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||
C-style date and time utilities | ||||||||||||||||||||||||||||||||||||||||
Defined in header <ctime>
|
||
time_t time( time_t *time );
|
||
Returns the current calendar time encoded as a time_t object.
Contents |
[edit] Parameters
time | - | pointer to a time_t object to store the time in or NULL |
[edit] Return value
Current calendar time encoded as time_t object on success, (time_t)(-1) on error. If the argument is not NULL, the return value is equal to the value stored in the object pointed to by the argument.
[edit] Notes
The encoding of calendar time in std::time_t is unspecified, but most systems conform to POSIX specification and return a value of integral type holding the number of seconds since the Epoch. Implementations in which time_t is a 32-bit signed integer (many historical implementations) fail in the year 2038.
[edit] Example
#include <ctime> #include <iostream> int main() { std::time_t result = std::time(NULL); std::cout << std::asctime(std::localtime(&result)) << result << " seconds since the Epoch\n"; }
Output:
Wed Sep 21 10:27:52 2011 1316615272 seconds since the Epoch
[edit] See also
|
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) |