strftime | Programming Place Plus　Ｃ言語編　標準ライブラリのリファレンス

概要

現在のロケールに応じた日時と時刻を表す文字列を返す。

ヘッダ

time.h

形式

size_t strftime(char* restrict s, size_t maxsize, const char* restrict format, const struct tm* restrict t);

引数

s

結果を格納する配列へのポインタ。

maxsize

結果の文字列の最大長。末尾のヌル文字を含む。

format

フォーマット指定文字列。

t

日付・時刻の情報が格納された tm構造体へのポインタ。

戻り値

結果の文字列が maxsize 以下であれば、s が指す配列へ実際に書き込まれた文字数（ヌル文字の分を除く）を返す。そうでなければ、0 を返す。

詳細

引数t が指す tm構造体のメンバの値を使って、現在のロケールの LC_TIMEカテゴリに応じた、日付・時刻の文字列を生成する。
引数format は、「%」で始まる文字の並びによって変換指令を与える。通常は、「%」と、それに続く１文字の変換指令文字の組み合わせである。変換指令と無関係な文字はそのままコピーされる。
変換指令文字は、以下のものがある。

表の中で登場する「週基準年」とは、ISO 8601 で規定されている定義で、 週の始まりを月曜日とし、1月4日を含んでいる週を、その年の第１週と考える。
「%」と変換指令文字の間に、「E」または「O」を挟み込むことで、代替形式を指定できる。これは、ロケールに依存するが、代替形式がないこともある。ない場合は、単に「E」「O」を無視して、通常の変換を行う。たとえば、“C”ロケールには代替形式がない。

注意

使用例

#include <stdio.h>
#include <locale.h>
#include <time.h>

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

    char str[256];

    puts(setlocale(LC_TIME, "ja-JP"));
    strftime(str, sizeof(str), "%x %X", t);
    puts(str);

    puts(setlocale(LC_TIME, "en-US"));
    strftime(str, sizeof(str), "%x %X", t);
    puts(str);
}

実行結果：

ja-JP
2017/05/23 11:56:41
en-US
5/23/2017 11:56:41 AM

関連

ワイド文字列版の wcsftime関数がある。

解説章