日時

[C言語] 日付を書式を指定して任意の文字列に変換する

2025-01-18更新日: 2025-01-18

C言語で日付を任意の文字列形式に変換するには、strftime関数を使用します。

この関数は、struct tm型のデータを指定した書式に従って文字列に変換します。

書式指定子には、年、月、日、時間などを表すための特定の文字が用意されており、例えば%Yは4桁の年、%mは2桁の月を表します。

これにより、ユーザーは自由に日付の表示形式をカスタマイズできます。

この機能は、ログの記録やユーザーインターフェースでの日付表示に役立ちます。

目次から探す

日付を任意の文字列に変換する方法
応用例
まとめ

日付を任意の文字列に変換する方法

C言語では、日付を任意の文字列に変換するために、標準ライブラリのstrftime関数を使用します。

この関数を使うことで、日付や時刻を指定したフォーマットで文字列に変換することができます。

以下では、基本的な変換例からカスタムフォーマットの作成、複数の書式指定子の組み合わせについて解説します。

基本的な変換例

strftime関数を使って、日付を基本的なフォーマットで文字列に変換する方法を紹介します。

#include <stdio.h>
#include <time.h>
int main() {
    // 現在の時刻を取得
    time_t t = time(NULL);
    struct tm *tm_info = localtime(&t);
    // 日付を文字列に変換
    char buffer[80];
    strftime(buffer, 80, "%Y-%m-%d", tm_info);
    printf("変換された日付: %s\n", buffer);
    return 0;
}

変換された日付: 2023-10-05

この例では、strftime関数を使用して、現在の日付を「年-月-日」の形式で文字列に変換しています。

カスタムフォーマットの作成

strftime関数を使って、独自のフォーマットで日付を文字列に変換することも可能です。

以下の例では、曜日を含めたフォーマットを作成します。

#include <stdio.h>
#include <time.h>
int main() {
    // 現在の時刻を取得
    time_t t = time(NULL);
    struct tm *tm_info = localtime(&t);
    // カスタムフォーマットで日付を文字列に変換
    char buffer[80];
    strftime(buffer, 80, "%A, %Y年%m月%d日", tm_info);
    printf("カスタムフォーマットの日付: %s\n", buffer);
    return 0;
}

カスタムフォーマットの日付: 木曜日, 2023年10月05日

この例では、曜日を含めた「曜日, 年年月月日日」の形式で日付を文字列に変換しています。

複数の書式指定子の組み合わせ

strftime関数では、複数の書式指定子を組み合わせて、より複雑なフォーマットを作成することができます。

以下の例では、日付と時刻を組み合わせたフォーマットを作成します。

#include <stdio.h>
#include <time.h>
int main() {
    // 現在の時刻を取得
    time_t t = time(NULL);
    struct tm *tm_info = localtime(&t);
    // 複数の書式指定子を組み合わせて日付と時刻を文字列に変換
    char buffer[80];
    strftime(buffer, 80, "%Y-%m-%d %H:%M:%S", tm_info);
    printf("日付と時刻: %s\n", buffer);
    return 0;
}

日付と時刻: 2023-10-05 14:30:45

この例では、「年-月-日時:分:秒」の形式で日付と時刻を文字列に変換しています。

strftime関数を使うことで、さまざまなフォーマットで日付や時刻を表現することが可能です。

応用例

C言語で日付を任意の文字列に変換する方法を理解したら、次はその応用例を見ていきましょう。

ここでは、日付と時刻の組み合わせやローカライズされたフォーマット、日付の比較とフォーマットの自動化、テストについて解説します。

日付と時刻の組み合わせ

日付と時刻を組み合わせて表示することで、より詳細な情報を提供できます。

以下の例では、日付と時刻を一緒にフォーマットしています。

#include <stdio.h>
#include <time.h>
int main() {
    // 現在の時刻を取得
    time_t t = time(NULL);
    struct tm *tm_info = localtime(&t);
    // 日付と時刻を組み合わせて文字列に変換
    char buffer[100];
    strftime(buffer, 100, "%Y年%m月%d日 %H時%M分%S秒", tm_info);
    printf("日付と時刻の組み合わせ: %s\n", buffer);
    return 0;
}

日付と時刻の組み合わせ: 2023年10月05日 14時30分45秒

この例では、日付と時刻を「年年月月日日時時分分秒秒」の形式で表示しています。

ローカライズされた日付フォーマット

ローカライズされた日付フォーマットを使用することで、異なる地域や文化に合わせた日付表示が可能です。

以下の例では、日本のローカライズされたフォーマットを使用しています。

#include <stdio.h>
#include <time.h>
#include <locale.h>
int main() {
    // ロケールを日本に設定
    setlocale(LC_TIME, "ja_JP.UTF-8");
    // 現在の時刻を取得
    time_t t = time(NULL);
    struct tm *tm_info = localtime(&t);
    // ローカライズされた日付フォーマットで文字列に変換
    char buffer[100];
    strftime(buffer, 100, "%x %X", tm_info);
    printf("ローカライズされた日付フォーマット: %s\n", buffer);
    return 0;
}

ローカライズされた日付フォーマット: 2023/10/05 14:30:45

この例では、setlocale関数を使用して日本のロケールを設定し、日付と時刻をローカライズされた形式で表示しています。

日付の比較とフォーマット

日付の比較を行い、その結果をフォーマットして表示することも可能です。

以下の例では、2つの日付を比較し、結果を表示します。

#include <stdio.h>
#include <time.h>
int main() {
    // 2つの日付を設定
    struct tm date1 = {0, 0, 0, 5, 9, 123}; // 2023年10月5日
    struct tm date2 = {0, 0, 0, 10, 9, 123}; // 2023年10月10日
    // 日付をtime_tに変換
    time_t time1 = mktime(&date1);
    time_t time2 = mktime(&date2);
    // 日付の比較
    if (difftime(time1, time2) < 0) {
        printf("日付1は日付2より前です。\n");
    } else if (difftime(time1, time2) > 0) {
        printf("日付1は日付2より後です。\n");
    } else {
        printf("日付1と日付2は同じです。\n");
    }
    return 0;
}

日付1は日付2より前です。

この例では、mktime関数を使用してstruct tmをtime_tに変換し、difftime関数で日付を比較しています。

日付フォーマットの自動化

日付フォーマットの自動化により、コードの再利用性を高めることができます。

以下の例では、関数を使って日付フォーマットを自動化しています。

#include <stdio.h>
#include <time.h>
void formatDate(char *buffer, size_t size, const char *format) {
    time_t t = time(NULL);
    struct tm *tm_info = localtime(&t);
    strftime(buffer, size, format, tm_info);
}
int main() {
    char buffer[100];
    formatDate(buffer, 100, "%Y-%m-%d %H:%M:%S");
    printf("自動化された日付フォーマット: %s\n", buffer);
    return 0;
}

自動化された日付フォーマット: 2023-10-05 14:30:45

この例では、formatDate関数を作成し、日付フォーマットを自動化しています。

これにより、異なるフォーマットを簡単に適用できます。

日付フォーマットのテスト

日付フォーマットのテストを行うことで、フォーマットが正しく適用されているか確認できます。

以下の例では、テスト用の関数を作成しています。

#include <stdio.h>
#include <time.h>
#include <string.h>
int testDateFormat(const char *expected, const char *format) {
    char buffer[100];
    time_t t = time(NULL);
    struct tm *tm_info = localtime(&t);
    strftime(buffer, 100, format, tm_info);
    return strcmp(buffer, expected) == 0;
}
int main() {
    if (testDateFormat("2023-10-05", "%Y-%m-%d")) {
        printf("テスト成功: フォーマットが正しいです。\n");
    } else {
        printf("テスト失敗: フォーマットが間違っています。\n");
    }
    return 0;
}

テスト成功: フォーマットが正しいです。

この例では、testDateFormat関数を使用して、指定したフォーマットが期待通りの結果を返すかどうかをテストしています。

テストを行うことで、フォーマットの正確性を確認できます。

まとめ

C言語で日付を任意の文字列に変換する方法を学ぶことで、プログラム内での日時の扱いがより柔軟になります。

strftime関数を使った基本的なフォーマットから、応用例やよくある質問への対応までを理解することで、日付処理のスキルを向上させることができます。

この記事を参考に、実際のプログラムで日付フォーマットを活用してみましょう。