【C言語】秒数を日時に変換する方法

2023-07-192024-07-22

C言語でプログラムを作成する際、秒数を具体的な日時(年、月、日、時、分、秒)に変換する方法を知っていると非常に便利です。

この記事では、秒数を日時に変換するための基本的な手順をわかりやすく説明します。

具体的には、time_t型の秒数を取得し、それをstruct tm型に変換して日時を取得する方法を学びます。

また、エラーハンドリングやタイムゾーン、夏時間(DST)の考慮についても触れます。

目次から探す

秒数を日時に変換する手順

C言語で秒数を日時に変換する方法について解説します。

具体的には、time_t型の秒数を取得し、それをstruct tm型に変換して日時を取得する手順を説明します。

time_t型の秒数を取得する

まず、C言語では時間を扱うためにtime_t型を使用します。

time_t型は、エポック(1970年1月1日 00:00:00 UTC)からの経過秒数を表します。

time()関数の使い方

time_t型の秒数を取得するためには、time()関数を使用します。

time()関数は、現在の時刻をtime_t型で返します。

#include <stdio.h>
#include <time.h>
int main() {
    time_t current_time;
    current_time = time(NULL); // 現在の時刻を取得
    printf("Current time in seconds since the Epoch: %ld\n", current_time);
    return 0;
}

現在の時刻を取得する方法

上記のコードでは、time(NULL)を使用して現在の時刻を取得しています。

time()関数にNULLを渡すことで、現在の時刻をtime_t型で返します。

秒数をstruct tmに変換する

次に、取得したtime_t型の秒数をstruct tm型に変換します。

これには、gmtime()関数またはlocaltime()関数を使用します。

gmtime()関数とlocaltime()関数の違い

gmtime()関数は、UTC(協定世界時)に基づいてtime_t型の秒数をstruct tm型に変換します。
localtime()関数は、ローカルタイム(システムのタイムゾーン)に基づいてtime_t型の秒数をstruct tm型に変換します。

gmtime()関数の使い方

gmtime()関数を使用して、time_t型の秒数をUTCに基づくstruct tm型に変換する方法を示します。

#include <stdio.h>
#include <time.h>
int main() {
    time_t current_time;
    struct tm *utc_time;
    current_time = time(NULL); // 現在の時刻を取得
    utc_time = gmtime(¤t_time); // UTCに変換
    printf("UTC time: %d-%02d-%02d %02d:%02d:%02d\n",
           utc_time->tm_year + 1900, utc_time->tm_mon + 1, utc_time->tm_mday,
           utc_time->tm_hour, utc_time->tm_min, utc_time->tm_sec);
    return 0;
}

localtime()関数の使い方

localtime()関数を使用して、time_t型の秒数をローカルタイムに基づくstruct tm型に変換する方法を示します。

#include <stdio.h>
#include <time.h>
int main() {
    time_t current_time;
    struct tm *local_time;
    current_time = time(NULL); // 現在の時刻を取得
    local_time = localtime(¤t_time); // ローカルタイムに変換
    printf("Local time: %d-%02d-%02d %02d:%02d:%02d\n",
           local_time->tm_year + 1900, local_time->tm_mon + 1, local_time->tm_mday,
           local_time->tm_hour, local_time->tm_min, local_time->tm_sec);
    return 0;
}

struct tmから日時を取得する

gmtime()またはlocaltime()関数を使用して取得したstruct tm構造体から、年、月、日、時、分、秒を取得することができます。

struct tmのメンバ変数の説明

struct tm構造体には以下のメンバ変数があります。

メンバ変数	説明
tm_year	年(1900年からの経過年数)
tm_mon	月(0-11、0が1月)
tm_mday	日(1-31)
tm_hour	時(0-23)
tm_min	分(0-59)
tm_sec	秒(0-60)
tm_wday	曜日(0-6、0が日曜日)
tm_yday	年内の日数(0-365)
tm_isdst	夏時間(DST)のフラグ(正の値：夏時間、0：非夏時間、負の値：不明)

年、月、日、時、分、秒の取得方法

struct tm構造体から年、月、日、時、分、秒を取得する方法を示します。

#include <stdio.h>
#include <time.h>
int main() {
    time_t current_time;
    struct tm *local_time;
    current_time = time(NULL); // 現在の時刻を取得
    local_time = localtime(¤t_time); // ローカルタイムに変換
    int year = local_time->tm_year + 1900;
    int month = local_time->tm_mon + 1;
    int day = local_time->tm_mday;
    int hour = local_time->tm_hour;
    int minute = local_time->tm_min;
    int second = local_time->tm_sec;
    printf("Year: %d\n", year);
    printf("Month: %d\n", month);
    printf("Day: %d\n", day);
    printf("Hour: %d\n", hour);
    printf("Minute: %d\n", minute);
    printf("Second: %d\n", second);
    return 0;
}

このようにして、time_t型の秒数を日時に変換し、年、月、日、時、分、秒を取得することができます。

エラーハンドリングと注意点

C言語で秒数を日時に変換する際には、いくつかのエラーハンドリングと注意点を考慮する必要があります。

これにより、プログラムが予期しない動作をするのを防ぎ、正確な日時情報を取得することができます。

エラーハンドリング

time()関数のエラーチェック

time()関数は現在の時刻を取得するために使用されますが、エラーが発生する可能性があります。

time()関数はエラーが発生した場合、(time_t)(-1)を返します。

これをチェックすることで、エラーを検出できます。

#include <stdio.h>
#include <time.h>
int main() {
    time_t current_time;
    current_time = time(NULL);
    if (current_time == (time_t)(-1)) {
        perror("time() failed");
        return 1;
    }
    printf("Current time: %ld\n", current_time);
    return 0;
}

上記のコードでは、time()関数が失敗した場合にエラーメッセージを表示し、プログラムを終了します。

localtime()、gmtime()関数のエラーチェック

localtime()およびgmtime()関数は、time_t型の値をstruct tm型に変換しますが、これらの関数もエラーが発生する可能性があります。

エラーが発生した場合、これらの関数はNULLを返します。

#include <stdio.h>
#include <time.h>
int main() {
    time_t current_time;
    struct tm *local_time;
    current_time = time(NULL);
    if (current_time == (time_t)(-1)) {
        perror("time() failed");
        return 1;
    }
    local_time = localtime(¤t_time);
    if (local_time == NULL) {
        perror("localtime() failed");
        return 1;
    }
    printf("Current local time: %s", asctime(local_time));
    return 0;
}

上記のコードでは、localtime()関数が失敗した場合にエラーメッセージを表示し、プログラムを終了します。

注意点

タイムゾーンの影響

localtime()関数はシステムのタイムゾーン設定に依存します。

異なるタイムゾーンで実行されると、異なる結果が得られる可能性があります。

タイムゾーンを明示的に設定する場合は、環境変数TZを使用することができます。

#include <stdio.h>
#include <time.h>
int main() {
    time_t current_time;
    struct tm *local_time;
    // タイムゾーンを設定
    setenv("TZ", "Asia/Tokyo", 1);
    tzset();
    current_time = time(NULL);
    if (current_time == (time_t)(-1)) {
        perror("time() failed");
        return 1;
    }
    local_time = localtime(¤t_time);
    if (local_time == NULL) {
        perror("localtime() failed");
        return 1;
    }
    printf("Current local time in Tokyo: %s", asctime(local_time));
    return 0;
}

上記のコードでは、タイムゾーンをAsia/Tokyoに設定しています。

夏時間(DST)の考慮

夏時間(Daylight Saving Time, DST)は、特定の地域で夏季に時計を1時間進める制度です。

localtime()関数は自動的に夏時間を考慮しますが、gmtime()関数はUTC(協定世界時)を使用するため、夏時間を考慮しません。

#include <stdio.h>
#include <time.h>
int main() {
    time_t current_time;
    struct tm *local_time, *gmt_time;
    current_time = time(NULL);
    if (current_time == (time_t)(-1)) {
        perror("time() failed");
        return 1;
    }
    local_time = localtime(¤t_time);
    if (local_time == NULL) {
        perror("localtime() failed");
        return 1;
    }
    gmt_time = gmtime(¤t_time);
    if (gmt_time == NULL) {
        perror("gmtime() failed");
        return 1;
    }
    printf("Current local time: %s", asctime(local_time));
    printf("Current GMT time: %s", asctime(gmt_time));
    return 0;
}

上記のコードでは、localtime()関数とgmtime()関数の両方を使用して、ローカルタイムとGMT(UTC)を表示しています。

夏時間が適用されている場合、ローカルタイムとGMTの間に1時間の差が生じることがあります。

これらのエラーハンドリングと注意点を考慮することで、C言語での秒数を日時に変換するプログラムがより堅牢で信頼性の高いものになります。