C++ Reference: Standard C++ Library reference: C Library: ctime: localtime

C++官网参考链接：https://cplusplus.com/reference/ctime/localtime/

函数 
<ctime>
localtime
struct tm * localtime (const time_t * timer);
将time_t转换为tm作为本地时间
使用timer指向的值用表示对应时间的值填充tm结构，这些值表示为本地时区。

形参
timer
指向time_t类型对象的指针，该对象包含时间值。
time_t是一种基本算术类型（arithmetic type）的别名，它能够表示函数time返回的时间。

返回值
一个指向tm结构的指针，其成员用与timer的本地时间表示相对应的值填充。
返回值指向一个内部对象，其有效性或值可能被后续对gmtime或localtime的调用所更改。

用例
/* localtime example */
#include <stdio.h>      /* puts, printf */
#include <time.h>       /* time_t, struct tm, time, localtime */

int main ()
{
  time_t rawtime;
  struct tm * timeinfo;

  time (&rawtime);
  timeinfo = localtime (&rawtime);
  printf ("Current local time and date: %s", asctime(timeinfo));

  return 0;
}
输出：

数据竞争
该函数访问由timer指向的对象。
该函数还访问和修改一个共享内部对象，这可能会在对gmtime和localtime的同时调用中引入数据竞争。有些库提供了避免这种数据竞争的替代函数：localtime_r（不可移植）。

异常（C++） 
无抛出保证：此函数从不抛出异常。