C言語のstruct tm入門(各メンバーの範囲と0始まりの落とし穴)

// tm_overview.c
// 現在のローカル時刻をstruct tmに分解し、生の値と表示用に補正した値を並べて表示します。
#include <stdio.h>
#include <time.h>

static void print_tm_detail(const struct tm *t) {
    // 生の値 (struct tmが保持している内部表現)
    printf("[raw]  tm_year=%d (years since 1900), tm_mon=%d (0..11), tm_mday=%d, tm_hour=%d, tm_min=%d, tm_sec=%d\n",
           t->tm_year, t->tm_mon, t->tm_mday, t->tm_hour, t->tm_min, t->tm_sec);

    // 表示用補正を施した値
    int year  = t->tm_year + 1900; // 1900年基準
    int month = t->tm_mon + 1;     // 0始まりを1始まりに
    printf("[disp] %04d-%02d-%02d %02d:%02d:%02d\n",
           year, month, t->tm_mday, t->tm_hour, t->tm_min, t->tm_sec);
}

int main(void) {
    time_t now = time(NULL);          // 今のUNIX時刻を取得
    // localtimeは説明対象外ですが、struct tmの実例を得るために使用します
    struct tm local = *localtime(&now);
    print_tm_detail(&local);
    return 0;
}

// fmt_tm.hints.c
// struct tmを人間向けに安全に表示する補助関数
#include <stdio.h>
#include <time.h>

void format_tm_ymdhms(const struct tm *t, char *buf, size_t bufsz) {
    int year  = t->tm_year + 1900; // 西暦に補正
    int month = t->tm_mon + 1;     // 1〜12に補正
    snprintf(buf, bufsz, "%04d-%02d-%02d %02d:%02d:%02d",
             year, month, t->tm_mday, t->tm_hour, t->tm_min, t->tm_sec);
}

int main(void) {
    time_t now = time(NULL);
    struct tm local = *localtime(&now);

    char s[32];
    format_tm_ymdhms(&local, s, sizeof s);
    printf("display: %s\n", s);
    return 0;
}

// parse_tm.c
// 文字列"YYYY-MM-DD HH:MM:SS"をstruct tmに詰める安全な例
#include <stdio.h>
#include <time.h>

static int is_leap(int year) { // yearは西暦
    return (year % 4 == 0 && year % 100 != 0) || (year % 400 == 0);
}

static int days_in_month(int year, int mon0) { // mon0は0〜11
    static const int base_days[12] = {31,28,31,30,31,30,31,31,30,31,30,31};
    if (mon0 == 1) { // 2月
        return base_days[1] + (is_leap(year) ? 1 : 0);
    }
    return base_days[mon0];
}

int parse_ymdhms_to_tm(const char *s, struct tm *out) {
    int Y, M, D, h, m, se;
    if (sscanf(s, "%d-%d-%d %d:%d:%d", &Y, &M, &D, &h, &m, &se) != 6) {
        return 0; // 形式不一致
    }
    if (Y < 1900 || M < 1 || M > 12) return 0;
    int mon0 = M - 1; // 0始まりへ
    int dim = days_in_month(Y, mon0);
    if (D < 1 || D > dim) return 0;
    if (h < 0 || h > 23) return 0;
    if (m < 0 || m > 59) return 0;
    if (se < 0 || se > 59) return 0; // 入門では0〜59を採用

    struct tm t = {0};
    t.tm_year = Y - 1900; // 1900年基準へ
    t.tm_mon  = mon0;     // 0〜11
    t.tm_mday = D;
    t.tm_hour = h;
    t.tm_min  = m;
    t.tm_sec  = se;
    t.tm_isdst = -1;      // サマータイム情報不明

    *out = t;
    return 1;
}

static void dump_tm_for_check(const struct tm *t) {
    printf("raw: year=%d, mon=%d, mday=%d, hour=%d, min=%d, sec=%d\n",
           t->tm_year, t->tm_mon, t->tm_mday, t->tm_hour, t->tm_min, t->tm_sec);
    printf("disp: %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);
}

int main(void) {
    struct tm t;
    if (parse_ymdhms_to_tm("2024-02-29 23:59:59", &t)) {
        puts("OK: 2024のうるう年は2/29が有効");
        dump_tm_for_check(&t);
    }
    if (!parse_ymdhms_to_tm("2025-02-29 12:00:00", &t)) {
        puts("NG: 2025はうるう年ではないため2/29は無効");
    }
    if (!parse_ymdhms_to_tm("2025-13-01 00:00:00", &t)) {
        puts("NG: 13月は無効。1〜12の範囲に直す");
    }
    return 0;
}

// bad_good_checks.c
// よくある境界チェックの誤りと正しい書き方
#include <stdio.h>

int main(void) {
    int M = 12; // 12月のつもり
    // 悪い例: "< 12"にしてしまい12が弾かれる
    if (M > 0 && M < 12) {
        puts("bad: 12月が無効になってしまう");
    }
    // 良い例: ">= 1 && <= 12"で両端を含める
    if (M >= 1 && M <= 12) {
        puts("good: 1〜12を正しく許可する");
    }
    return 0;
}

// month_index.c
// 月ごとの表示名や最大日数を0始まり配列で扱い、tm_monと自然に対応づける
#include <stdio.h>

static const char *MONTH_NAME[12] = {
    "Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"
};

int main(void) {
    int tm_mon = 0; // 1月は0
    printf("tm_mon=%d -> month name=%s\n", tm_mon, MONTH_NAME[tm_mon]);

    tm_mon = 11; // 12月は11
    printf("tm_mon=%d -> month name=%s\n", tm_mon, MONTH_NAME[tm_mon]);
    return 0;
}