函式
<ctime>

localtime

struct tm * localtime (const time_t * timer);
將 time_t 轉換為本地時間的 tm 結構
使用 timer 所指向的值來填充一個 tm 結構體,其值表示對應於本地時區的時間。

引數

timer
指向 time_t 型別物件的指標,該物件包含一個時間值。
time_t 是一個基礎算術型別的別名,能夠表示由函式 time 返回的時間。

返回值

一個指向 tm 結構體的指標,其成員將被填充為 timer 對應的本地時間表示。

返回的值指向一個內部物件,其有效性或值可能會被任何後續對 gmtimelocaltime 的呼叫所改變。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
/* 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;
}

輸出

Current local time and date: Wed Feb 13 17:17:11 2013


資料競爭

該函式訪問由 timer 指向的物件。
該函式還會訪問和修改一個共享的內部物件,這可能在併發呼叫 gmtimelocaltime 時引入資料競爭。一些庫提供了一個替代函式來避免這種資料競爭:localtime_r(非可移植)。

異常 (C++)

無異常保證:此函式從不丟擲異常。

另見