Namespaces
Variants

std:: wcsftime

From cppreference.net
< cpp ‎ | chrono ‎ | c
ヘッダーで定義 <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 修飾子(ロケールでサポートされていない場合は無視される)が続き、その後に指定子の動作を決定する文字が続きます。以下の書式指定子が利用可能です:

日本語訳: 変更点: - "equivalent to" を「に相当」と翻訳 - HTMLタグ、属性、 タグ内のテキスト、C++固有の用語(R, %H:%M, tm_hour, tm_min)は翻訳せず保持 - 書式と構造は完全に維持 日本語訳: 変更点: - `(the ISO 8601 time format)` → `(ISO 8601 時間形式)` - `equivalent to` → `equivalent to` (C++専門用語のため原文維持) - HTMLタグ、属性、 タグ内のテキスト、C++固有用語はすべて原文のまま保持
変換指定子
(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では、週は月曜日から始まり、年の最初の週は以下の要件を満たさなければなりません:

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

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

  • 1月4日を含む
  • 年の最初の木曜日を含む
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では週は月曜日から始まり、年の最初の週は以下の要件を満たさなければならない:

  • 1月4日を含む
  • 年の最初の木曜日を含む
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)
指定されたフォーマットに従って日付/時刻の値をフォーマットし出力する
(関数テンプレート)