C言語の標準ライブラリstrftimeのリファレンスです。
概要 | 時間を指定された書式に従って変換する。 |
ヘッダ | #include <time.h> |
I/F | size_t strftime(char * restrict s, size_t maxsize, const char * restrict format, const struct tm * restrict timeptr); |
戻り値 | 終端ナル文字を含む結果の文字の総数がmaxsize個以下の場合はsで指される配列に格納された文字数(終端ナル文字は含めない)。そうでなければ0 。 |
詳細 | strftime関数は、timeptrで示された情報をformatで指定された書式に従って変換し、配列sに格納する。時間や日付の変換はロケール情報のLC_TIMEカテゴリに基づいて行われる。maxsizeを超える個数の文字を配列に格納することはできない。 書式に使用できる変換指定子は次の通りである。 %a … ロケールの簡略化された曜日の名前。 %A … ロケールの簡略化されていない曜日の名前。 %b … ロケールの簡略化された月の名前。 %B … ロケールの簡略化されていない月の名前。 %c … ロケールの適切な日付及び時刻表現。 %C … 西暦の年を100で除算し、整数に切り捨てた数(00〜99)。 %d … 月の日(01〜31)。 %D … "%m/%d/%y"と同じ日付表現。 %e … 月の日(1〜31)。1けたの数の場合、空白文字を前に置く。 %F … "%Y-%m-%d"と同じ日付表現。 %g … 暦週に基づく年の下2けた(00〜99)。 %G … 暦週に基づく年(例:2011)。 %h … "%b"と同じ。 %H … 時間(00〜23)。 %I … 時間(01〜12)。 %j … 年の日(001〜366)。 %m … 月(01〜12)。 %M … 分(00〜59)。 %n … 改行文字。 %p … ロケールの12時間制に関連した午前又は午後の表記に相当するもの。 %r … ロケールの12時間制での時刻表現。 %R … “%H:%M"と同じ。 %S … 秒(00〜60)。 %t … 水平タブ文字。 %T … “%H:%M:%S"と同じ。 %u … JIS X 0301が規定する暦週の中の日の序数(1〜7)。月曜日は1。 %U … 年の週の数(00〜53)。最初の日曜日を第1週の最初の日とする。 %V … JIS X 0301が規定する暦週の序数(01〜53)。 %w … 曜日(0〜6)。日曜日を0とする。 %W … 年の週番号(00〜53)。最初の月曜日を第1週の最初の日とする。 %x … ロケールの適切な日付表現。 %X … ロケールの適切な時刻表現。 %y … 西暦の下2けたの年(00〜99)。 %Y … 西暦の年(例:2011)。 %z … UTCからの時差をJIS X 0301が規定する形式で表したもの。時間帯不明なら置換されない。 %Z … 時間帯の名前又は略号。時間帯不明なら置換されない。 %% … %。 %Ec … ロケールでの日付及び時刻の代替表現。 %EC … ロケールでの代替表現である年号。 %Ex … ロケールでの日付の代替表現。 %EX … ロケールでの時刻の代替表現。 %Ey … ロケールでの代替表現である%EC(年号)に対応した年。 %EY … ロケールでの年の完全形式の代替表現。 %Od … ロケールでの代替数値記号を使った日の表現。必要に応じて0を前置。0に対応する代替数値記号が存在しないなら空白文字を前置。 %Oe … ロケールでの代替数値記号を使った日の表現。必要に応じて空白文字を前置。 %OH … ロケールでの代替数値記号を使った時間(24時間制)の表現。 %OI … ロケールでの代替数値記号を使った時間(12時間制)の表現。 %Om … ロケールでの代替数値記号を使った月の表現。 %OM … ロケールでの代替数値記号を使った分の表現。 %OS … ロケールでの代替数値記号を使った秒の表現。 %Ou … ロケールでの代替表現によるJIS X 0301が規定する暦週の中の序数。月曜日は1。 %OU … ロケールでの代替数値記号を使った週番号の表現。 %OV … ロケールでの代替数値記号を使ったJIS X 0301が規定する暦週の序数の表現。 %Ow … ロケールでの代替数値記号を使った曜日の表現。 %OW … ロケールでの代替数値記号を使った年の週番号の表現。 %Oy … ロケールでの代替数値記号を使った西暦の下2けたの年。 |