次の方法で共有


strftime、wcsftime、_strftime_l、_wcsftime_l

時刻文字列を書式化します。

size_t strftime(
   char *strDest,
   size_t maxsize,
   const char *format,
   const struct tm *timeptr 
);
size_t _strftime_l(
   char *strDest,
   size_t maxsize,
   const char *format,
   const struct tm *timeptr,
   _locale_t locale
);
size_t wcsftime(
   wchar_t *strDest,
   size_t maxsize,
   const wchar_t *format,
   const struct tm *timeptr 
);
size_t _wcsftime_l(
   wchar_t *strDest,
   size_t maxsize,
   const wchar_t *format,
   const struct tm *timeptr,
   _locale_t locale
);

パラメーター

  • strDest
    出力する文字列。

  • maxsize
    文字が使用されます strDest バッファーのサイズ (char または wchart_t)。

  • format
    書式指定文字列。

  • timeptr
    tm の データ構造。

  • locale
    使用するロケール。

戻り値

strftime は strDest に配置された文字数を返します wcsftime はワイド文字の対応する番号を返します。

文字数が、終端の null を含む) の数より多い場合は、maxsizestrftime と wcsftime 0 の両方を返し、strDest の内容は不確定です。

strDest の文字数が書式指定コードによって format に追加できる format リテラル文字、文字の数と同じになります。 文字列の終端の null は戻り値としてカウントされます。

解説

strftime と wcsftime 関数は format の指定された引数に従って timeptr の tm の時刻の値の書式を指定して、buffer strDestに結果を保存します*。*最大でも maxsize の文字が文字列内に挿入されます。 timeptr 構造体のフィールドの詳細については、「asctime」を参照してください。 wcsftime は strftimeのワイド文字単位の等価です; ワイド文字列へのアクセス文字列ポインター引数のポイント。 それ以外では、これらの関数の動作は同じです。

注意

Visual C++ 2005 以前のバージョンでは、ドキュメントが記述されていますが const wchar_t *データ型を持つとして wcsftime の format パラメーターを、format のデータ型の実際の実装は const char *でした。formatのデータ型の実装は前と現在のドキュメント、つまり const wchar_t *を反映するように更新されました。

この関数は、パラメーターを検証します。 strDest、format、またはtimeptr が null ポインターの場合、または timeptr して対処する tm のデータ構造が無効 (たとえば、時間または日付の範囲内の値を含む場合、) である場合は format の文字列に無効な書式指定コードが含まれる場合、無効なパラメーター ハンドラーが パラメーターの検証"に説明されているように、呼び出されます。 実行の継続が許可された場合、この関数は 0 を返し、errno を EINVAL に設定します。

汎用テキスト ルーチンのマップ

TCHAR.H のルーチン

_UNICODE & _MBCS が未定義の場合

_MBCS が定義されている場合

_UNICODE が定義されている場合

_tcsftime

strftime

strftime

wcsftime

format の引数は一つ以上のコードで構成されます。; printfと同様に、書式指定コードがパーセント記号 (%) が付きます。 % という文字が strDestにコピーされます*。*現在のロケールの LC_TIME のカテゴリは strftimeの出力書式に影響します。(LC_TIMEの詳細については、「setlocale」を参照してください。_l サフィックスのない関数は、現在設定されているロケールを使用します。 _l のサフィックスが付いているこれらの関数の各バージョンは同じですが、ロケールをパラメーターとして受け取り、現在設定されているロケールの代わりに使用します。 詳細については、「ロケール」を参照してください。

strftime の書式指定コードを次に示します。:

  • %a
    曜日の名前

  • %A
    曜日の正式名

  • %b
    省略された月名

  • %B
    完全な月名

  • %c
    ロケールの適切な日付と時刻の表現

  • %d
    10 進数 (01 – 31) として月の日

  • %H
    24 時間制 (00 – 23 時間)

  • %I
    12 時間制 (01 – 12 時間)

  • %j
    10 進数 (001) として– 366 年の日

  • %m
    10 進数 (01 – 12) として月

  • %M
    10 進数 (00) として– 59 分

  • %p
    12 時間制の現在のロケールの午前/アフリカーンス語.のインジケーター

  • %S
    second として 10 進数 (00 – 59)

  • %U
    最初に曜日 (00 – 53) の日付として Sunday の 10 進数として年の週、

  • %w
    10 進数 (0 – 6 として Weekday; 日曜日は 0)

  • %W
    最初に曜日 (00 – 53) の日付として Monday の 10 進数として年の週、

  • %x
    現在のロケールの日付の表現

  • %X
    現在のロケールの時刻の表現

  • %y
    10 進数 (00 – 99) として世紀のではなく、

  • %Y
    10 進数として世紀の年、

  • %z, %Z
    レジストリの設定によって、タイム ゾーンの名前またはタイム ゾーンの省略形、; タイム ゾーンが不明な場合は文字なし

  • %%
    パーセント記号

printf 関数と同様に、# フラグは書式指定コードを付け加える場合があります。 この場合、書式指定コードの意味は、次のように変更されます。

[書式コード]

説明

%#a, %#A, %#b, %#B, %#p, %#X, %#z, %#Z, %#%

# フラグは無視されます。

%#c

長い日付と時刻の表現は現在のロケールでは、割り当てます。 例: 「Tuesday November 1995 (3 年 12 月 14 日 12:41: 29 "です。

%#x

長い日付形式は現在のロケールに、割り当てます。 例: 「Tuesday November 1995 (3 年 12 月 14 日」。

%#d, %#H, %#I, %#j, %#m, %#M, %#S, %#U, %#w, %#W, %#y, %#Y

先行するゼロを削除します (存在する場合)。

必要条件

ルーチン

必須ヘッダー

strftime

<time.h>

wcsftime

<time.h または> wchar.h <>

_strftime_l

<time.h>

_wcsftime_l

<time.h または> wchar.h <>

互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。

使用例

time」の例を参照してください。

同等の .NET Framework 関数

参照

関連項目

ロケール

時間管理

文字列操作 (CRT)

localeconv

setlocale、_wsetlocale

strcoll 系関数

strxfrm、wcsxfrm、_strxfrm_l、_wcsxfrm_l