std:: wcsftime
|
ヘッダーで定義
<cwchar>
|
||
|
std::
size_t
wcsftime
(
wchar_t
*
str,
std::
size_t
count,
const
wchar_t
*
format,
const
std::
tm
*
time
)
;
|
||
与えられたカレンダー時刻 time から日時情報を変換し、 フォーマット文字列 format に従ってヌル終端ワイド文字列 str に書き込みます。最大 count 個のワイド文字が書き込まれます。
目次 |
パラメータ
| str | - | 出力用の wchar_t 配列の最初の要素へのポインタ |
| count | - | 書き込むワイド文字の最大数 |
| format | - | 変換の フォーマット を指定するnull終端ワイド文字列へのポインタ |
| time | - | 変換する日付と時刻情報へのポインタ |
フォーマット文字列
書式文字列は、0個以上の変換指定子と普通の文字(
%
を除く)で構成されます。すべての普通の文字(終端のヌル文字を含む)は変更されずに出力文字列にコピーされます。各変換指定は
%
文字で始まり、オプションで
E
または
O
修飾子(ロケールでサポートされていない場合は無視される)が続き、その後に指定子の動作を決定する文字が続きます。以下の書式指定子が利用可能です:
|
変換指定子
(Conversion specifier) |
説明 | 使用されるフィールド |
|---|---|---|
%
|
リテラル
%
を書き込む。完全な変換指定は
%%
でなければならない。
|
|
n
(C++11) |
改行文字を書き込む | |
t
(C++11) |
水平タブ文字を書き込む | |
| 年 | ||
Y
|
年を10進数で書き込みます、例: 2017 |
tm_year
|
EY
(C++11) |
代替表現で 年 を書き込む。例えば、ja_JPロケールでは2011年ではなく平成23年(Heisei 23年) |
tm_year
|
y
|
年の下2桁を10進数で書き込む(範囲
[00,99]
)
|
tm_year
|
Oy
(C++11) |
年 の下2桁を代替数値システムで書き込む。例:ja_JPロケールでは11の代わりに十一 |
tm_year
|
Ey
(C++11) |
年
をロケールの代替カレンダー期間
%EC
からのオフセットとして書き込む
(ロケール依存)
|
tm_year
|
C
(C++11) |
年の最初の2桁を10進数で書き込む(範囲
[00,99]
)
|
tm_year
|
EC
(C++11) |
ロケールの代替表現で 基準年(期間) の名前を書き出す、例えば ja_JP ロケールでの 平成(平成時代) |
tm_year
|
G
(C++11) |
ISO 8601 週ベースの年
を書き込みます。つまり、指定された週を含む年です。
ISO 8601では、週は月曜日から始まり、年の最初の週は以下の要件を満たさなければなりません:
|
tm_year
,
tm_wday
,
tm_yday
|
g
(C++11) |
ISO 8601 週ベースの年
の下2桁を書き込む。すなわち、指定された週を含む年(範囲
[00,99]
)。
ISO 8601では週は月曜日から始まり、年の最初の週は以下の要件を満たさなければならない:
|
tm_year
,
tm_wday
,
tm_yday
|
| 月 | ||
b
|
省略形の月名
を書き込みます。例:
Oct
(ロケール依存)
|
tm_mon
|
h
(C++11) |
b
の同義語
|
tm_mon
|
B
|
完全な月名を書き出す、例:
October
(ロケール依存)
|
tm_mon
|
m
|
月を10進数で書き込む(範囲
[01,12]
)
|
tm_mon
|
Om
(C++11) |
代替数値システムを使用して 月 を書き込む、例えばja_JPロケールでは12の代わりに十二 |
tm_mon
|
| 週 | ||
U
|
週番号を10進数で書き込む(日曜日を週の最初の日とする)(範囲
[00,53]
)
|
tm_year
,
tm_wday
,
tm_yday
|
OU
(C++11) |
代替数値システムを使用して
年間の週
を書き込みます。
%U
によるものと同様で、例えばja_JPロケールでは52の代わりに五十二を使用します
|
tm_year
,
tm_yday
,
tm_wday
|
W
|
年における週
を10進数で書き出す
(月曜日が週の最初の日)(範囲
[00,53]
)
|
tm_year
,
tm_wday
,
tm_yday
|
OW
(C++11) |
代替数値システムを使用して 年間の週 を書き込みます。例:ja_JPロケールで52の代わりに五十二 |
tm_year
,
tm_wday
,
tm_yday
|
V
(C++11) |
ISO 8601 週番号
を書き込む
(範囲は
[01,53]
)。
ISO 8601では週は月曜日から始まり、年の最初の週は以下の要件を満たさなければならない:
|
tm_year
,
tm_wday
,
tm_yday
|
OV
(C++11) |
代替数値システムを使用して
年間の週
を書き込みます。
%V
によるもの、例えば ja_JP ロケールでは 52 の代わりに 五十二
|
tm_year
,
tm_wday
,
tm_yday
|
| 年間/月間の日付 | ||
j
|
年通算日を10進数で出力(範囲
[001,366]
)
|
tm_yday
|
d
|
月の日を10進数で書き込む(範囲
[01,31]
)
|
tm_mday
|
Od
(C++11) |
代替数値システムを使用して0から始まる
月の日
を書き込む(例:ja_JPロケールでは27の代わりに二十七)
単一文字の場合は前にスペースが付く。 |
tm_mday
|
e
(C++11) |
月の日を10進数で書き込みます(範囲
[1,31]
)。
1桁の数字の前にはスペースが付加されます。 |
tm_mday
|
Oe
(C++11) |
代替数値システムを使用して1から始まる
月の日
を書き込む(例:ja_JPロケールでは27の代わりに二十七)
単一文字の前にはスペースが付きます。 |
tm_mday
|
| 曜日 | ||
a
|
省略形の曜日名
を書き込みます。例:
Fri
(ロケール依存)
|
tm_wday
|
A
|
完全な曜日名を書き出す、例:
Friday
(ロケール依存)
|
tm_wday
|
w
|
曜日を10進数で書き込みます。日曜日は
0
となります
(範囲
[0-6]
)
|
tm_wday
|
Ow
(C++11) |
代替数値システムを使用して
weekday
を書き込みます。日曜日は
0
で、ja_JPロケールでは2の代わりに二のように表示されます
|
tm_wday
|
u
(C++11) |
weekday
を10進数で書き込みます。月曜日は
1
となります(ISO 8601形式)(範囲
[1-7]
)
|
tm_wday
|
Ou
(C++11) |
weekday
を書き込みます。月曜日は
1
で、代替の数値システムを使用します(例:ja_JPロケールでは2の代わりに二)
|
tm_wday
|
| 時、分、秒 | ||
H
|
時間を10進数で書き込みます、24時間制(範囲
[00-23]
)
|
tm_hour
|
OH
(C++11) |
24時間制の 時間 を代替数値システムで書き込む、例えばja_JPロケールでは18の代わりに十八 |
tm_hour
|
I
|
時間を12時間制の10進数で書き込みます(範囲
[01,12]
)
|
tm_hour
|
OI
(C++11) |
12時間制で 時間 を代替数値システムを使用して書き込む、例えば ja_JP ロケールでは 06 の代わりに 六 |
tm_hour
|
M
|
分を10進数で書き込む(範囲
[00,59]
)
|
tm_min
|
OM
(C++11) |
代替数値システムを使用して 分 を書き込む。例:ja_JPロケールでは25の代わりに二十五 |
tm_min
|
S
|
秒を10進数で書き込む(範囲
[00,60]
)
|
tm_sec
|
OS
(C++11) |
代替数値システムを使用して 秒 を書き込みます。例:ja_JPロケールでは24の代わりに二十四 |
tm_sec
|
| その他 | ||
c
|
標準日時文字列
を書き込む、例:
Sun Oct 17 04:41:13 2010
(ロケール依存)
|
すべて |
Ec
(C++11) |
代替の日付と時刻文字列を 書き出す 。例:ja_JPロケールで2011年 (year 2011) の代わりに平成23年 (year Heisei 23) を使用 | すべて |
x
|
ローカライズされた 日付表現 を書き込む (ロケール依存) | すべて |
Ex
(C++11) |
代替日付表現
を書き込む
例: ja_JPロケールで2011年 (year 2011) の代わりに平成23年 (year Heisei 23) を使用する |
すべて |
X
|
ローカライズされた 時刻表現 を書き込む (例: 18:40:20 または 6:40:20 PM(ロケール依存)) | すべて |
EX
(C++11) |
代替時間表現を書き込む (ロケール依存) | すべて |
D
(C++11) |
equivalent to "%m/%d/%y" |
tm_mon
,
tm_mday
,
tm_year
|
F
(C++11) |
"%Y-%m-%d" と同等 (ISO 8601 日付形式) |
tm_mon
,
tm_mday
,
tm_year
|
r
(C++11) |
ローカライズされた 12時間制 時刻を書き込む(ロケール依存) |
tm_hour
,
tm_min
,
tm_sec
|
R
(C++11) |
equivalent to "%H:%M" |
tm_hour
,
tm_min
|
R
(C++11) |
equivalent to "%H:%M" に相当 |
tm_hour
,
tm_min
|
T
(C++11) |
equivalent to "%H:%M:%S" (the ISO 8601 time format) |
tm_hour
,
tm_min
,
tm_sec
|
T
(C++11) |
equivalent to "%H:%M:%S" (ISO 8601 時間形式) |
tm_hour
,
tm_min
,
tm_sec
|
p
|
ローカライズされた a.m. または p.m. を書き込む(ロケール依存) |
tm_hour
|
z
(C++11) |
UTCからの
オフセット
をISO 8601形式で書き込む(例:
-0430
)、またはタイムゾーン情報が利用できない場合は文字を出力しない
|
tm_isdst
|
Z
|
ロケール依存の タイムゾーン名または略称 を書き込む。タイムゾーン情報が利用できない場合は文字を出力しない |
tm_isdst
|
戻り値
成功時に、 str が指すワイド文字配列に書き込まれたワイド文字数(終端の L ' \0 ' を含まない)。文字列全体を格納する前に count に達した場合は、 0 が返され、内容は未定義となる。
例
#include <ctime> #include <cwchar> #include <iostream> #include <locale> int main() { std::locale::global(std::locale("ja_JP.utf8")); std::time_t t = std::time(nullptr); wchar_t wstr[100]; if (std::wcsftime(wstr, 100, L"%A %c", std::localtime(&t))) std::wcout << wstr << '\n'; }
出力例:
火曜日 2011年12月27日 17時43分13秒
関連項目
|
std::tm
オブジェクトをカスタムテキスト表現に変換する
(関数) |
|
|
(C++11)
|
指定されたフォーマットに従って日付/時刻の値をフォーマットし出力する
(関数テンプレート) |
|
Cドキュメント
for
wcsftime
|
|