|
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Defined in header <ctime> | ||
std::tm* localtime(conststd::time_t* time); | ||
Converts given time since epoch asstd::time_t value into calendar time, expressed in local time.
Contents |
| time | - | pointer to astd::time_t object to convert |
Pointer to a static internalstd::tm object on success, or null pointer otherwise. The structure may be shared betweenstd::gmtime,std::localtime, andstd::ctime, and may be overwritten on each invocation.
This function may not be thread-safe. TheMicrosoft CRT implementation is thread-safe.
POSIX requires that this function setserrno toEOVERFLOW if it fails because the argument is too large.
POSIX specifies that the timezone information is determined by this function as if by callingtzset, which reads the environment variableTZ.
#include <ctime>#include <iomanip>#include <iostream>#include <sstream> int main(){ setenv("TZ","/usr/share/zoneinfo/America/Los_Angeles",1);// POSIX-specific std::tm tm{};// Zero initialize tm.tm_year=2020-1900;// 2020 tm.tm_mon=2-1;// February tm.tm_mday=15;// 15th tm.tm_hour=10; tm.tm_min=15; tm.tm_isdst=0;// Not daylight savingstd::time_t t=std::mktime(&tm); std::cout<<"UTC: "<<std::put_time(std::gmtime(&t),"%c %Z")<<'\n';std::cout<<"local: "<<std::put_time(std::localtime(&t),"%c %Z")<<'\n';}
Possible output:
UTC: Sat Feb 15 18:15:00 2020 GMTlocal: Sat Feb 15 10:15:00 2020 PST
| converts time since epoch to calendar time expressed as Universal Coordinated Time (function)[edit] | |
(C23)(C11) | converts time since epoch to calendar time expressed as local time (function)[edit] |
C documentation forlocaltime | |
