日時

[C言語] 日時を文字列に変換する方法

2025-04-15更新日: 2025-04-15

C言語で日時を文字列に変換するには、strftime関数を使用します。

この関数は、time_t型の日時データをフォーマット指定子に従って文字列に変換します。

まず、time_t型の変数に現在の日時を取得し、localtime関数でtm構造体に変換します。

次に、strftime関数を用いて、tm構造体のデータを指定したフォーマットで文字列に変換します。

フォーマット指定子には、年、月、日、時、分、秒などを表すものがあり、自由に組み合わせて使用できます。

目次から探す

日時の取得と変換の流れ
応用例：カスタムフォーマットの作成
エラーハンドリングとデバッグ
まとめ

日時の取得と変換の流れ

C言語で日時を文字列に変換するためには、いくつかのステップを踏む必要があります。

ここでは、time_t型とtime関数、tm構造体とlocaltime関数、そしてstrftime関数を用いた変換手順について詳しく解説します。

time_t型とtime関数

time_t型は、C言語で時間を表現するためのデータ型です。

time関数を使用することで、現在の時刻をtime_t型で取得することができます。

#include <stdio.h>
#include <time.h>
int main() {
    // 現在の時刻を取得
    time_t currentTime;
    time(&currentTime);
    // 取得した時刻を表示
    printf("現在の時刻(time_t型): %ld\n", currentTime);
    return 0;
}

現在の時刻(time_t型): 1672531199

この例では、time関数を使って現在の時刻をtime_t型で取得し、その値を表示しています。

time_t型の値は、1970年1月1日からの経過秒数として表現されます。

tm構造体とlocaltime関数

tm構造体は、年月日や時分秒などの詳細な時間情報を格納するための構造体です。

localtime関数を使用することで、time_t型の時刻をtm構造体に変換することができます。

#include <stdio.h>
#include <time.h>
int main() {
    // 現在の時刻を取得
    time_t currentTime;
    time(&currentTime);
    // time_t型をtm構造体に変換
    struct tm *localTime = localtime(&currentTime);
    // 変換した時刻を表示
    printf("年: %d\n", localTime->tm_year + 1900);
    printf("月: %d\n", localTime->tm_mon + 1);
    printf("日: %d\n", localTime->tm_mday);
    printf("時: %d\n", localTime->tm_hour);
    printf("分: %d\n", localTime->tm_min);
    printf("秒: %d\n", localTime->tm_sec);
    return 0;
}

年: 2023
月: 10
日: 1
時: 12
分: 34
秒: 56

この例では、localtime関数を使ってtime_t型の時刻をtm構造体に変換し、各要素を表示しています。

tm_yearは1900年からの年数、tm_monは0から始まる月を表すため、それぞれ補正が必要です。

strftime関数を用いた変換手順

strftime関数を使用することで、tm構造体の情報を指定したフォーマットの文字列に変換することができます。

#include <stdio.h>
#include <time.h>
int main() {
    // 現在の時刻を取得
    time_t currentTime;
    time(&currentTime);
    // time_t型をtm構造体に変換
    struct tm *localTime = localtime(&currentTime);
    // 文字列に変換
    char buffer[80];
    strftime(buffer, sizeof(buffer), "%Y-%m-%d %H:%M:%S", localTime);
    // 変換した文字列を表示
    printf("フォーマットされた日時: %s\n", buffer);
    return 0;
}

フォーマットされた日時: 2023-10-01 12:34:56

この例では、strftime関数を使ってtm構造体の情報を”YYYY-MM-DD HH:MM:SS”形式の文字列に変換しています。

strftime関数は、フォーマット指定子を用いて出力形式を柔軟に指定できるため、様々な形式の日時文字列を生成することが可能です。

応用例：カスタムフォーマットの作成

C言語で日時を文字列に変換する際、strftime関数を用いることで、様々なカスタムフォーマットを作成することができます。

ここでは、年月日、時分秒、そして日付と時間の組み合わせフォーマットの作成方法について解説します。

年月日のカスタムフォーマット

年月日を独自のフォーマットで表示したい場合、strftime関数のフォーマット指定子を活用します。

例えば、”YYYY年MM月DD日”の形式で表示することができます。

#include <stdio.h>
#include <time.h>
int main() {
    // 現在の時刻を取得
    time_t currentTime;
    time(&currentTime);
    // time_t型をtm構造体に変換
    struct tm *localTime = localtime(&currentTime);
    // 年月日のカスタムフォーマット
    char dateBuffer[80];
    strftime(dateBuffer, sizeof(dateBuffer), "%Y年%m月%d日", localTime);
    // 変換した文字列を表示
    printf("カスタムフォーマットの年月日: %s\n", dateBuffer);
    return 0;
}

カスタムフォーマットの年月日: 2023年10月01日

この例では、%Y、%m、%dを用いて、年、月、日をそれぞれ日本語の”年”、”月”、”日”と組み合わせたフォーマットで表示しています。

時分秒のカスタムフォーマット

時分秒を独自のフォーマットで表示することも可能です。

例えば、”HH時MM分SS秒”の形式で表示することができます。

#include <stdio.h>
#include <time.h>
int main() {
    // 現在の時刻を取得
    time_t currentTime;
    time(&currentTime);
    // time_t型をtm構造体に変換
    struct tm *localTime = localtime(&currentTime);
    // 時分秒のカスタムフォーマット
    char timeBuffer[80];
    strftime(timeBuffer, sizeof(timeBuffer), "%H時%M分%S秒", localTime);
    // 変換した文字列を表示
    printf("カスタムフォーマットの時分秒: %s\n", timeBuffer);
    return 0;
}

カスタムフォーマットの時分秒: 12時34分56秒

この例では、%H、%M、%Sを用いて、時、分、秒をそれぞれ日本語の”時”、”分”、”秒”と組み合わせたフォーマットで表示しています。

日付と時間の組み合わせフォーマット

日付と時間を組み合わせたフォーマットを作成することもできます。

例えば、”YYYY/MM/DD HH:MM:SS”の形式で表示することができます。

#include <stdio.h>
#include <time.h>
int main() {
    // 現在の時刻を取得
    time_t currentTime;
    time(&currentTime);
    // time_t型をtm構造体に変換
    struct tm *localTime = localtime(&currentTime);
    // 日付と時間の組み合わせフォーマット
    char dateTimeBuffer[80];
    strftime(dateTimeBuffer, sizeof(dateTimeBuffer), "%Y/%m/%d %H:%M:%S", localTime);
    // 変換した文字列を表示
    printf("カスタムフォーマットの日付と時間: %s\n", dateTimeBuffer);
    return 0;
}

カスタムフォーマットの日付と時間: 2023/10/01 12:34:56

この例では、日付と時間をスラッシュとコロンで区切ったフォーマットで表示しています。

strftime関数を用いることで、様々なフォーマットを柔軟に作成することが可能です。

エラーハンドリングとデバッグ

C言語で日時を文字列に変換する際、エラーハンドリングとデバッグは重要な要素です。

ここでは、strftime関数の戻り値の確認方法、デバッグ時の注意点、そしてよくあるエラーとその対処法について解説します。

strftime関数の戻り値の確認

strftime関数は、変換された文字列の長さを返しますが、バッファが不足している場合は0を返します。

この戻り値を確認することで、変換が成功したかどうかを判断できます。

#include <stdio.h>
#include <time.h>
int main() {
    // 現在の時刻を取得
    time_t currentTime;
    time(&currentTime);
    // time_t型をtm構造体に変換
    struct tm *localTime = localtime(&currentTime);
    // 文字列に変換
    char buffer[80];
    size_t result = strftime(buffer, sizeof(buffer), "%Y-%m-%d %H:%M:%S", localTime);
    // 戻り値を確認
    if (result == 0) {
        printf("エラー: バッファが不足しています。\n");
    } else {
        printf("フォーマットされた日時: %s\n", buffer);
    }
    return 0;
}

この例では、strftime関数の戻り値を確認し、バッファが不足している場合にエラーメッセージを表示しています。