C言語のgmtimeでUTCに変換する方法とstruct tmの基本

#include <stdio.h>   // printf
#include <time.h>    // time, time_t, gmtime, struct tm

int main(void) {
    // 現在のUNIX時刻(UTC起点の経過秒)を取得
    time_t now = time(NULL);
    if (now == (time_t)-1) {
        // 取得失敗(非常にまれ)
        fprintf(stderr, "time() failed\n");
        return 1;
    }

    // gmtimeでUTCの要素別時刻に分解(静的領域へのポインタが返る点に注意)
    struct tm *utc = gmtime(&now);
    if (utc == NULL) {
        // 変換できない(範囲外など)場合
        fprintf(stderr, "gmtime() failed\n");
        return 1;
    }

    // 年と月は基準に合わせて補正する
    int year = utc->tm_year + 1900;
    int mon  = utc->tm_mon + 1;

    // ゼロ埋めで読みやすく表示
    printf("%04d-%02d-%02d %02d:%02d:%02d UTC\n",
           year, mon, utc->tm_mday, utc->tm_hour, utc->tm_min, utc->tm_sec);
    return 0;
}

#include <stdio.h>
#include <time.h>

static void print_utc(time_t t) {
    struct tm *utc = gmtime(&t);
    if (!utc) {
        printf("gmtime() failed for t=%lld\n", (long long)t);
        return;
    }
    printf("t=%lld -> %04d-%02d-%02d %02d:%02d:%02d UTC\n",
           (long long)t,
           utc->tm_year + 1900, utc->tm_mon + 1, utc->tm_mday,
           utc->tm_hour, utc->tm_min, utc->tm_sec);
}

int main(void) {
    // 代表例: UNIXエポック(1970-01-01 00:00:00 UTC)
    time_t t0 = 0;

    // 例: 2021-01-01 00:00:00 UTC は 1609459200
    time_t t1 = 1609459200;

    print_utc(t0);
    print_utc(t1);
    return 0;
}

#include <stdio.h>
#include <time.h>

int main(void) {
    time_t now = time(NULL);
    struct tm *utc = gmtime(&now);
    if (!utc) return 1;

    int year = utc->tm_year + 1900;
    int mon  = utc->tm_mon + 1;
    int day_of_week = utc->tm_wday; // 0:日, 1:月, ... 6:土
    int day_of_year = utc->tm_yday; // 0:1月1日

    printf("年=%d, 月=%d, 日=%d, 時=%d, 分=%d, 秒=%d, 曜日=%d, 年内通し日=%d\n",
           year, mon, utc->tm_mday, utc->tm_hour, utc->tm_min, utc->tm_sec,
           day_of_week, day_of_year);
    return 0;
}

#include <stdio.h>
#include <time.h>

int main(void) {
    time_t t1 = 0;             // 1970-01-01
    time_t t2 = 1609459200;    // 2021-01-01

    // 悪い例: どちらも同じ静的領域を指し、2回目の呼び出しで上書きされる
    struct tm *p1 = gmtime(&t1);
    struct tm *p2 = gmtime(&t2);
    // ここでp1の内容はp2と同じになっている可能性が高い
    printf("悪い例: p1=%04d-%02d-%02d, p2=%04d-%02d-%02d\n",
           p1->tm_year + 1900, p1->tm_mon + 1, p1->tm_mday,
           p2->tm_year + 1900, p2->tm_mon + 1, p2->tm_mday);

    // 良い例: すぐに値コピーして独立した構造体として保持する
    struct tm a = *gmtime(&t1);
    struct tm b = *gmtime(&t2);
    printf("良い例: a=%04d-%02d-%02d, b=%04d-%02d-%02d\n",
           a.tm_year + 1900, a.tm_mon + 1, a.tm_mday,
           b.tm_year + 1900, b.tm_mon + 1, b.tm_mday);
    return 0;
}

#include <stdio.h>
#include <time.h>
#include <errno.h>

int main(void) {
    // かなり大きな値(環境により扱えない可能性あり)
    time_t t = (time_t)9e18;

    struct tm *utc = gmtime(&t);
    if (utc == NULL) {
        // gmtimeはerrnoを必ず設定するとは限らないので、表示は参考程度
        fprintf(stderr, "gmtime() failed for t=%lld (errno=%d)\n", (long long)t, errno);
        return 1;
    }
    printf("%04d-%02d-%02d %02d:%02d:%02d UTC\n",
           utc->tm_year + 1900, utc->tm_mon + 1, utc->tm_mday,
           utc->tm_hour, utc->tm_min, utc->tm_sec);
    return 0;
}

#include <stdio.h>
#include <time.h>

int main(void) {
    time_t now = time(NULL);

    // すぐにコピーして静的領域の上書きを回避
    struct tm utc = *gmtime(&now);
    struct tm loc = *localtime(&now);

    printf("UTC : %04d-%02d-%02d %02d:%02d:%02d\n",
           utc.tm_year + 1900, utc.tm_mon + 1, utc.tm_mday,
           utc.tm_hour, utc.tm_min, utc.tm_sec);

    printf("LOCAL: %04d-%02d-%02d %02d:%02d:%02d\n",
           loc.tm_year + 1900, loc.tm_mon + 1, loc.tm_mday,
           loc.tm_hour, loc.tm_min, loc.tm_sec);
    return 0;
}

#include <stdio.h>
#include <time.h>

int main(void) {
    time_t now = time(NULL);
    struct tm *utc = gmtime(&now);
    if (!utc) return 1;

    printf("%04d-%02d-%02d %02d:%02d:%02d UTC\n",
           utc->tm_year + 1900, utc->tm_mon + 1, utc->tm_mday,
           utc->tm_hour, utc->tm_min, utc->tm_sec);
    return 0;
}

#include <stdio.h>
#include <time.h>

int main(void) {
    time_t now = time(NULL);
    if (now == (time_t)-1) {
        fprintf(stderr, "time() failed\n");
        return 1;
    }

    struct tm tmp;
    struct tm *utc = gmtime(&now);
    if (!utc) {
        fprintf(stderr, "gmtime() failed\n");
        return 1;
    }
    // 安全のため即座にコピーしてから使う
    tmp = *utc;

    printf("%04d-%02d-%02d %02d:%02d:%02d UTC\n",
           tmp.tm_year + 1900, tmp.tm_mon + 1, tmp.tm_mday,
           tmp.tm_hour, tmp.tm_min, tmp.tm_sec);
    return 0;
}