strftime() — 日付/時刻からストリングへの変換

フォーマット

#include <time.h>
size_t strftime(char *s, size_t maxsize, const char *format,
                   const struct tm *timeptr);

言語レベル

ANSI

スレッド・セーフ

はい

ロケール依存

この関数の振る舞いは、現行ロケールの LC_CTYPE、LC_TIME、および LC_TOD カテゴリーの影響を受ける可能性があります。詳細については、CCSID およびロケールの理解を参照してください。

説明

strftime() 関数は、format が指す制御ストリングで指定された形式で、 s が指す配列にバイトを入れます。書式ストリングは、ゼロ個以上の変換指定と 普通文字で構成されています。変換指定は、% 文字と 変換の振る舞いを決定する終了変換文字で構成されています。 すべての普通文字 (終了ヌル・バイトおよびマルチバイト文字を含む) は、 変更されないまま配列にコピーされます。オーバーラップしたオブジェクト間で コピーが行われる場合には、振る舞いは予期できません。 maxsize までのバイトが配列に入ります。 該当する文字は、timeptr が指す構造体に含まれる値 と現行ロケールに保管された値によって決定されます。

標準変換指定は、それぞれ該当する文字で置き換えられます。次の表を参照してください。

変更された変換指定子

いくつかの変換指定子は、E または O 修飾子文字により変更可能です。 この変更を行うことで、通常使用されている未変更変換指定子の変わりに、代替の形式や指定方法 が使用されるべきであることを示すことができます。 変換された変換指定子が 現行ロケールで使用不可になっているフィールドを使用する場合、 振る舞いは未変更変換指定が使用されたかのようになります。 例えば、era ストリングが空ストリング "" (ストリングは使用不可であることを意味します) である場合、%EY が %Y のように振る舞います。

戻り値

終了ヌル・バイトを含む結果バイトの合計数が maxsize を超えない場合、strftime() は、終了ヌル・バイトを含まない、 s が指す配列に配置されたバイト数を戻します。 それ以外の場合は、0 が戻され、配列の内容は 不確定となります。

変換エラーが発生した場合、errno は ECONVERT に設定される可能性があります。

例

#include <stdio.h>
#include <time.h>
 
int main(void)
{
     char s[100];
     int rc;
     time_t temp;
     struct tm *timeptr;

     temp = time(NULL);
     timeptr = localtime(&temp);

     rc = strftime(s,sizeof(s),"Today is %A, %b %d.¥nTime:  %r", timeptr);
     printf("%d characters written.¥n%s¥n",rc,s);

     return 0;
}

/*************************************************
     The output should be similar to:
     46 characters written
     Today is Wednesday, Oct 24.
     Time:  01:01:15 PM
************************************************************/

関連情報