std::wcsftime

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

日付と時刻ライブラリ

時間点 time_point (C++11) clock_time_conversion (C++20)   clock_cast (C++20) 時間間隔 duration (C++11) クロック system_clock (C++11) steady_clock (C++11) is_clock (C++20) utc_clock (C++20) tai_clock (C++20) high_resolution_clock (C++11) gps_clock (C++20) file_clock (C++20) local_t (C++20) 時刻 is_amis_pm (C++20)(C++20) make12make24 (C++20)(C++20) hh_mm_ss (C++20)

カレンダー day (C++20) month (C++20) year (C++20) weekday (C++20) operator/ (C++20) year_month_day (C++20) year_month_day_last (C++20) year_month_weekday (C++20) year_month_weekday_last (C++20)   weekday_indexed (C++20) weekday_last (C++20) month_day (C++20) month_day_last (C++20) month_weekday (C++20) month_weekday_last (C++20) year_month (C++20) last_speclast (C++20)(C++20) chrono I/O parse (C++20)

タイムゾーン tzdb (C++20) tzdb_list (C++20) get_tzdbget_tzdb_listreload_tzdbremote_version (C++20)(C++20)(C++20)(C++20) sys_info (C++20) local_info (C++20) nonexistent_local_time (C++20) ambiguous_local_time (C++20) locate_zone (C++20) current_zone (C++20) time_zone (C++20) choose (C++20) zoned_traits (C++20) zoned_time (C++20) time_zone_link (C++20) leap_second (C++20) leap_second_info (C++20) get_leap_second_info (C++20) C スタイルの日付と時刻

 

C-style の日付と時刻ユーティリティ

関数

時刻操作

difftime

time

clock

timespec_get (C++17)

書式変換

asctime

ctime

strftime

wcsftime

gmtime

localtime

mktime

定数

CLOCKS_PER_SEC

型

tm

time_t

clock_t

timespec (C++17)

 

ヘッダ <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	-	変換のフォーマットを指定する、ヌル終端のワイド文字文字列へのポインタ
time	-	変換される日付と時刻の情報へのポインタ

フォーマット文字列

フォーマット文字列は、0個以上の変換指定子と通常の文字（% を除く）で構成されます。すべての通常の文字（終端のヌル文字を含む）は、変更なしに出力文字列にコピーされます。各変換指定子は % 文字で始まり、オプションで E または O 修飾子（ロケールでサポートされていない場合は無視される）が続き、指定子の動作を決定する文字が続きます。次のフォーマット指定子が利用可能です。

変換 指定子	説明	使用されるフィールド
%	リテラルの % を出力します。完全な変換指定子は %% である必要があります。
n (C++11)	改行文字を出力します。
t (C++11)	水平タブ文字を出力します。
年
Y	年を10進数で出力します。例: 2017	tm_year
EY (C++11)	ja_JP ロケールでの 2011年 (2011年) の代わりに、代替表現での年を出力します。例: 平成23年 (23年 平成)	tm_year
y	年の下2桁を10進数（範囲 [00,99]）で出力します。	tm_year
Oy (C++11)	ja_JP ロケールでの 11 の代わりに、代替数値システムを使用した年の下2桁を出力します。例: 十一	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)	ja_JP ロケールでの 52 の代わりに、%U と同様の年の週を代替数値システムを使用して出力します。例: 五十二	tm_year、tm_wday、tm_yday
W	（月曜日を週の最初の曜日とした）年の週を10進数（範囲 [00,53]）で出力します。	tm_year、tm_wday、tm_yday
OW (C++11)	ja_JP ロケールでの 52 の代わりに、%W と同様の年の週を代替数値システムを使用して出力します。例: 五十二	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)	ja_JP ロケールでの 52 の代わりに、%V と同様の年の週を代替数値システムを使用して出力します。例: 五十二	tm_year、tm_wday、tm_yday
年の日/月
j	年の日を10進数（範囲 [001,366]）で出力します。	tm_yday
d	月のsilylを10進数（範囲 [01,31]）で出力します。	tm_mday
Od (C++11)	ja_JP ロケールでの 27 の代わりに、代替数値システムを使用した0ベースの月のsilylを出力します。例: 二十七 単一の文字の前にスペースが付きます。	tm_mday
e (C++11)	月のsilylを10進数（範囲 [1,31]）で出力します。 単一の数字の前にスペースが付きます。	tm_mday
Oe (C++11)	ja_JP ロケールでの 27 の代わりに、代替数値システムを使用した1ベースの月のsilylを出力します。例: 二十七 単一の文字の前にスペースが付きます。	tm_mday
曜日
a	（ロケール依存）省略曜日の名前を出力します。例: Fri	tm_wday
A	（ロケール依存）曜日のフルネームを出力します。例: Friday	tm_wday
w	曜日を10進数で出力します。日曜日が 0 です（範囲 [0-6]）。	tm_wday
Ow (C++11)	ja_JP ロケールでの 2 の代わりに、代替数値システムを使用した曜日（日曜日が 0）を出力します。例: 二	tm_wday
u (C++11)	曜日を10進数で出力します。月曜日が 1 です（ISO 8601 形式）（範囲 [1-7]）。	tm_wday
Ou (C++11)	ja_JP ロケールでの 2 の代わりに、代替数値システムを使用した曜日（月曜日が 1）を出力します。例: 二	tm_wday
時、分、秒
H	時を24時間形式の10進数（範囲 [00-23]）で出力します。	tm_hour
OH (C++11)	ja_JP ロケールでの 18 の代わりに、代替数値システムを使用した24時間形式の時を出力します。例: 十八	tm_hour
I	時を12時間形式の10進数（範囲 [01,12]）で出力します。	tm_hour
OI (C++11)	ja_JP ロケールでの 06 の代わりに、代替数値システムを使用した12時間形式の時を出力します。例: 六	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年 (2011年) の代わりに、平成23年 (23年 平成) を使用するなど、代替の日付と時刻の文字列を出力します。	すべて
x	（ロケール依存）ローカライズされた日付表現を出力します。	すべて
Ex (C++11)	ja_JP ロケールでの 2011年 (2011年) の代わりに、平成23年 (23年 平成) を使用するなど、代替の日付表現を出力します。	すべて
X	（ロケール依存）ローカライズされた時刻表現を出力します。例: 18:40:20 または 6:40:20 PM。	すべて
EX (C++11)	（ロケール依存）代替の時刻表現を出力します。	すべて
D (C++11)	"%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)	"%H:%M" と同等です。	tm_hour、tm_min
T (C++11)	"%H:%M:%S" (ISO 8601 時刻フォーマット) と同等です。	tm_hour、tm_min、tm_sec
p	（ロケール依存）ローカライズされた午前または午後を出力します。	tm_hour
z (C++11)	ISO 8601 形式でのUTCからのオフセット（例: -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秒

関連項目

strftime	std::tm オブジェクトをカスタムのテキスト表現に変換する (関数)
put_time (C++11)	指定されたフォーマットに従って日付/時刻の値をフォーマットして出力する (関数テンプレート)
Cドキュメント （wcsftime について）