strftime
|
ヘッダーで定義
<time.h>
|
||
| (C99まで) | ||
| (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では、週は月曜日から始まり、年の最初の週は以下の要件を満たさなければなりません:
|
tm_year
,
tm_wday
,
tm_yday
|
g
(C99) |
指定された週を含む年、すなわち
ISO 8601週ベースの年
の下2桁を書き込む(範囲
[00,99]
)。
ISO 8601では週は月曜日から始まり、年の最初の週は以下の要件を満たさなければならない:
|
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では週は月曜日から始まり、年の最初の週は以下の要件を満たさなければならない:
|
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
オブジェクトをテキスト表現に変換する
(関数) |
|
(C95)
|
tm
オブジェクトをカスタムワイド文字列のテキスト表現に変換する
(関数) |
|
C++ documentation
for
strftime
|
|