【C/C++】strftime()関数の使い方と主な書式指定子を解説

strftime()関数とは

C言語およびC++のstrftime()関数は、日付や時刻を指定した書式の文字列に整形（フォーマット）するための関数です。C言語では「time.h」ヘッダーファイル内で宣言されています。戻り値としては、文字列にコピーされた総文字数を返します。ただし、生成された文字列が引数sizeで指定したサイズに収まらない場合は0を返します。

構文

size_t strftime(char *string, size_t size, const char *format, const struct tm *time_pointer)

各パラメータの意味

• string：整形結果を格納する出力先配列へのポインタ。
• size：コピーされる最大文字数。
• format：tm構造体に格納された時刻を表現するための書式指定子。
• time_pointer：暦時刻（カレンダー時刻）を含むtm構造体へのポインタ。

使用例

#include <stdio.h>
#include <time.h>
int main () {
    time_t tim;
    struct tm *detl;
    char buf[80];
    time( &tim );
    detl = localtime( &tim );
    strftime(buf, 20, "%x - %I:%M%p", detl);
    printf("Date & time after formatting : %s", buf );
    return(0);
}

実行結果

Date & time after formatting : 10/23/18 - 10:33AM

プログラムの解説

上記のプログラムでは、異なるデータ型の変数を3つ宣言しています。まずtime()関数で現在の時刻を取得し、続いてlocaltime()関数によって現在の日付と時刻がtm構造体に格納されます。その後、strftime()関数が書式指定子を使って文字列をバッファへコピーし、指定された形式に整形しています。

detl = localtime( &tim );
strftime(buf, 20, "%x - %I:%M%p", detl);

主な書式指定子一覧

strftime()関数でよく使われる書式指定子は以下の通りです。これらを組み合わせることで、目的に応じた柔軟な日付・時刻表示が可能になります。