使用localtime函數輸出本地時間

引言

在計算機編程中，我們需要經常獲取時間，例如記錄程序運行時間、生成時間戳等。當我們需要顯示本地時間時，可以使用localtime函數將UTC時間（世界標準時間）轉換為本地時間。下面將詳細介紹localtime函數的用法。

localtime函數的用法

1. localtime函數的定義

localtime函數是C和C++語言的標準函數之一，用於將時間戳（time_t類型）轉換為本地時間（struct tm類型）。

2. localtime函數的參數

localtime函數只有一個參數，即time_t類型的時間戳。時間戳表示從1970年1月1日00:00:00到指定時間的秒數，可以使用time函數獲取。

time_t now = time(NULL);
struct tm *t = localtime(&now);

3. localtime函數的返回值

localtime函數返回一個指向struct tm類型結構體的指針，結構體中包含了本地時間的年、月、日、時、分、秒等信息。

#include 
#include 

int main()
{
    time_t now = time(NULL);
    struct tm *t = localtime(&now);
    printf("當前本地時間： %04d-%02d-%02d %02d:%02d:%02d\n", 
            t->tm_year + 1900, t->tm_mon + 1, t->tm_mday, 
            t->tm_hour, t->tm_min, t->tm_sec);
    return 0;
}

輸出結果：

當前本地時間： 2022-07-08 14:39:56

4. localtime函數的注意事項

在使用localtime函數時，需要注意以下幾點：

4.1 localtime函數的返回值指向靜態的結構體

localtime函數返回的結構體指針指向一個靜態的結構體，多線程環境下應該使用localtime_r函數。

4.2 使用mktime函數將struct tm結構體轉換為時間戳

如果我們需要將struct tm類型的本地時間轉換為時間戳，可以使用mktime函數。

struct tm t;
t.tm_year = 2022 - 1900;
t.tm_mon = 6;
t.tm_mday = 8;
t.tm_hour = 14;
t.tm_min = 49;
t.tm_sec = 0;
time_t now = mktime(&t);

4.3 localtime函數的跨時區問題

localtime函數將時間戳轉換為本地時間依賴於系統時區設置，如果跨時區使用可能會出現錯誤的本地時間。可以使用tzset函數設置時區變數，以支持多時區操作。

#include 
#include 
#include 

int main()
{
    setenv("TZ", "Europe/Paris", 1); // 設置時區為巴黎
    tzset(); // 更新時區變數
    time_t now = time(NULL);
    struct tm *t = localtime(&now);
    printf("巴黎時間： %04d-%02d-%02d %02d:%02d:%02d\n", 
            t->tm_year + 1900, t->tm_mon + 1, t->tm_mday, 
            t->tm_hour, t->tm_min, t->tm_sec);

    setenv("TZ", "America/New_York", 1); // 設置時區為紐約
    tzset(); // 更新時區變數
    now = time(NULL);
    t = localtime(&now);
    printf("紐約時間： %04d-%02d-%02d %02d:%02d:%02d\n", 
            t->tm_year + 1900, t->tm_mon + 1, t->tm_mday, 
            t->tm_hour, t->tm_min, t->tm_sec);
    return 0;
}