Namespaces
Variants

strftime

From cppreference.net
ヘッダーで定義 <time.h>
size_t strftime ( char * str, size_t count,
const char * format, const struct tm * tp ) ;
(C99まで)
size_t strftime ( char * restrict str, size_t count,
const char * restrict format, const struct tm * restrict tp ) ;
(C99以降)

指定された暦時刻 tp から日時情報を、 書式文字列 format に従ってナル終端マルチバイト文字列 str に変換します。最大 count バイトが書き込まれます。

目次

パラメータ

str - 出力用 char 配列の最初の要素へのポインタ
count - 書き込む最大バイト数
format - 変換フォーマット を指定するnull終端マルチバイト文字列へのポインタ
tp - フォーマットする時刻を指定する struct tm オブジェクトへのポインタ

フォーマット文字列

書式文字列は、0個以上の変換指定子と( % 以外の)通常の文字で構成されます。すべての通常の文字(終端のnull文字を含む)は変更されずに出力文字列にコピーされます。各変換指定は % 文字で始まり、オプションで E または O 修飾子(ロケールでサポートされていない場合は無視される)が続き、その後に指定子の動作を決定する文字が続きます。以下の書式指定子が利用可能です:

変換指定子
説明 使用されるフィールド
% リテラルの % を書き出す。 完全な変換指定は %% でなければならない。
n
(C99)
改行文字を書き込む
t
(C99)
水平タブ文字を書き込む
Y 年を10進数で書き込みます、例: 2017 tm_year
EY
(C99)
代替表現で を書き込みます。例えば、ja_JPロケールでは2011年 (year 2011) の代わりに平成23年 (year Heisei 23) となります tm_year
y 年の下2桁を10進数で書き込む(範囲 [00,99] tm_year
Oy
(C99)
代替数値システムを使用して の下2桁を書き込む(例:ja_JPロケールでは11の代わりに十一) tm_year
Ey
(C99)
をロケールの代替カレンダー期間 %EC からのオフセットとして書き込む (ロケール依存) tm_year
C
(C99)
年の最初の2桁を10進数で書き込む(範囲 [00,99] tm_year
EC
(C99)
ロケールの代替表現で 基準年(期間) の名称を書き出す、例えば ja_JP ロケールでの 平成 (平成時代) tm_year
G
(C99)
ISO 8601 週ベースの年 を書き込みます。つまり、指定された週を含む年です。

ISO 8601では、週は月曜日から始まり、年の最初の週は以下の要件を満たさなければなりません:

  • 1月4日を含む
  • 年の最初の木曜日を含む
tm_year , tm_wday , tm_yday
g
(C99)
指定された週を含む年、すなわち ISO 8601週ベースの年 の下2桁を書き込む(範囲 [00,99] )。

ISO 8601では週は月曜日から始まり、年の最初の週は以下の要件を満たさなければならない:

  • 1月4日を含む
  • 年の最初の木曜日を含む
tm_year tm_wday tm_yday
b 省略形の月名 を書き込む、例: Oct (ロケール依存) tm_mon
Ob
(C23)
ロケールの代替表現で 省略月名 を書き込む tm_mon
h
(C99)
b の同義語 tm_mon
B 完全な月名を書き出す、例: October (ロケール依存) tm_mon
OB
(C23)
ロケールの代替表現で適切な 完全な月名 を書き込む tm_mon
m 月を10進数で書き込む(範囲 [01,12] tm_mon
Om
(C99)
代替数値システムを使用して を書き込みます。例:ja_JPロケールでは12の代わりに十二 tm_mon
U 週番号を10進数で書き込む(日曜日を週の最初の日とする)(範囲 [00,53] tm_year , tm_wday , tm_yday
OU
(C99)
代替数値システムを使用して 年間の週 を書き込みます。 %U によるものと同様で、例えばja_JPロケールでは52の代わりに五十二を使用します tm_year , tm_wday , tm_yday
W 年における週 を10進数で書き出す (月曜日が週の最初の日)(範囲 [00,53] tm_year , tm_wday , tm_yday
OW
(C99)
代替数値システムを使用して 年間の週 を書き込みます。例えば ja_JP ロケールでは 52 の代わりに 五十二 tm_year , tm_wday , tm_yday
V
(C99)
ISO 8601の年間週 を書き込む (範囲 [01,53] )。

ISO 8601では週は月曜日から始まり、年の最初の週は以下の要件を満たさなければならない:

  • 1月4日を含む
  • 年の最初の木曜日を含む
tm_year , tm_wday , tm_yday
OV
(C99)
代替数値システムを使用して 年間の週 を書き込みます。 %V によるもの。例: ja_JPロケールでは52の代わりに五十二 tm_year , tm_wday , tm_yday
年間/月間の日付
j 年通算日を10進数で出力(範囲 [001,366] tm_yday
d 月の日を10進数で書き込む(範囲 [01,31] tm_mday
Od
(C99)
代替数値システムを使用して0から始まる 月の日 を書き込む(例:ja_JPロケールでは27の代わりに二十七)

単一文字の前にはスペースが付く。

tm_mday
e
(C99)
日付を10進数で書き込む(範囲 [1,31] )。

1桁の場合は前にスペースが付きます。

tm_mday
Oe
(C99)
代替数値システムを使用して1から始まる 月の日 を書き込む(例:ja_JPロケールでは27の代わりに二十七)

単一文字の前にはスペースが付きます。

tm_mday
曜日
a 省略形の曜日名を書き込みます。例: Fri (ロケール依存) tm_wday
A 完全な曜日名を書き出す、例: Friday (ロケール依存) tm_wday
w 曜日を10進数で書き込みます。日曜日は 0 となります (範囲 [0-6] ) tm_wday
Ow
(C99)
代替数値システムを使用して 曜日 を書き込みます。日曜日は 0 で、例えばja_JPロケールでは2の代わりに二を使用します tm_wday
u
(C99)
月曜日を 1 とする 曜日 を10進数で出力する(ISO 8601形式)(範囲 [1-7] tm_wday
Ou
(C99)
代替数値システムを使用して 曜日 を書き込みます。月曜日は 1 で、例えばja_JPロケールでは2の代わりに二を使用します tm_wday
時、分、秒
H 時間を10進数で書き込む、24時間制(範囲 [00-23] tm_hour
OH
(C99)
24時間制の 時間 を代替数値システムで書き出す、例えばja_JPロケールでは18の代わりに十八 tm_hour
I 時間を12時間制の10進数で書き込みます(範囲 [01,12] tm_hour
OI
(C99)
12時間制で 時間 を代替数値システムを使用して書き込む(例:ja_JPロケールで06の代わりに六) tm_hour
M 分を10進数で書き込む(範囲 [00,59] tm_min
OM
(C99)
代替数値システムを使用して を書き込む(例:ja_JPロケールで25の代わりに二十五) tm_min
S 秒を10進数で書き込む(範囲 [00,60] tm_sec
OS
(C99)
代替数値システムを使用して を書き込みます。例:ja_JPロケールでは24の代わりに二十四 tm_sec
その他
c 標準の日付と時刻文字列を書き込む、例: Sun Oct 17 04:41:13 2010 (ロケール依存) すべて
Ec
(C99)
代替の日付と時刻文字列を 書き出す 、例えばja_JPロケールで2011年 (year 2011) の代わりに平成23年 (year Heisei 23) を使用する すべて
x ローカライズされた 日付表現 を書き込む (ロケール依存) すべて
Ex
(C99)
代替日付表現を 書き出す 、例えばja_JPロケールで2011年 (year 2011) の代わりに平成23年 (year Heisei 23) を使用する すべて
X ローカライズされた 時刻表現 を書き込む、例:18:40:20 または 6:40:20 PM(ロケール依存) すべて
EX
(C99)
代替時刻表現 を書き込む
(ロケール依存)
すべて
D
(C99)
"%m/%d/%y" と同等 tm_mon , tm_mday , tm_year
F
(C99)
%Y-%m-%d に相当 "%Y-%m-%d" (ISO 8601 日付形式) tm_mon , tm_mday , tm_year
r
(C99)
ローカライズされた 12時間制 時刻を書き込む(ロケール依存) tm_hour , tm_min , tm_sec
R
(C99)
"%H:%M" に相当 tm_hour , tm_min
T
(C99)
%H:%M:%S "%H:%M:%S" に相当 (ISO 8601 時刻形式) tm_hour , tm_min , tm_sec
p ローカライズされた a.m. または p.m. を書き込む(ロケール依存) tm_hour
z
(C99)
UTCからの オフセット をISO 8601形式で書き込む(例: -0430 )、またはタイムゾーン情報が利用できない場合は文字を出力しない tm_isdst
Z ロケール依存の タイムゾーン名または略称 を書き込む。タイムゾーン情報が利用できない場合は文字を出力しない tm_isdst

戻り値

str が指す文字配列に書き込まれたバイト数(終端の ' \0 ' を含まない)。文字列全体を格納する前に count に達した場合、 0 が返され、内容は不定となる。

#include <locale.h>
#include <stdio.h>
#include <time.h>
int main(void)
{
    char buff[70];
    struct tm my_time = { .tm_year = 112, // = 年 2012
                          .tm_mon = 9,    // = 10月
                          .tm_mday = 9,   // = 9日
                          .tm_hour = 8,   // = 8時間
                          .tm_min = 10,   // = 10分
                          .tm_sec = 20    // = 20秒
    };
    if (strftime(buff, sizeof buff, "%A %c", &my_time))
        puts(buff);
    else
        puts("strftime failed");
    setlocale(LC_TIME, "el_GR.utf8");
    if (strftime(buff, sizeof buff, "%A %c", &my_time))
        puts(buff);
    else
        puts("strftime failed");
}

出力例:

Sunday Sun Oct  9 08:10:20 2012
Κυριακή Κυρ 09 Οκτ 2012 08:10:20 πμ EST

参考文献

  • C23規格 (ISO/IEC 9899:2024):
  • 7.27.3.5 strftime関数 (p: TBD)
  • C17規格 (ISO/IEC 9899:2018):
  • 7.27.3.5 strftime関数 (p: 288-291)
  • C11規格 (ISO/IEC 9899:2011):
  • 7.27.3.5 strftime関数 (p: 394-397)
  • C99規格 (ISO/IEC 9899:1999):
  • 7.23.3.5 strftime関数 (p: 343-347)
  • C89/C90標準 (ISO/IEC 9899:1990):
  • 4.12.3.5 strftime関数

関連項目

(C23で非推奨) (C11)
tm オブジェクトをテキスト表現に変換する
(関数)
(C23で非推奨) (C11)
time_t オブジェクトをテキスト表現に変換する
(関数)
tm オブジェクトをカスタムワイド文字列のテキスト表現に変換する
(関数)
C++ documentation for strftime