Cライブラリ関数 -strftime()

C 标准库 - <time.h>C標準ライブラリ - <time.h>

説明

Cライブラリ関数size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr)は、formatで定義されたフォーマット規則に従って、構造体timeptrが表す時間をフォーマットし、それをstrに格納します。

宣言

以下は strftime() 関数の宣言です。

size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr)

パラメータ

  • str-- これは、生成された C 文字列をコピーするための宛先配列を指すポインタです。
  • maxsize-- これは、str にコピーされる最大文字数です。
  • format-- これは C 文字列で、通常の文字と特殊なフォーマット指定子の任意の組み合わせを含みます。これらのフォーマット指定子は、関数によって tm で指定された時間を表す対応する値に置き換えられます。フォーマット指定子は次のとおりです:
指定子置き換え例
%a曜日の短縮名Sun
%A完全な曜日名Sunday
%b月の短縮名Mar
%B完全な月名March
%c日付と時刻の表現Sun Aug 19 02:56:02 2012
%d月の何日目か(01-31)19
%H24時間形式の時(00-23)14
%I12時間形式の時(01-12)05
%j年の何日目か(001-366)231
%m10進数で表した月(01-12)08
%M分(00-59)55
%pAM または PM の名前PM
%S秒(00-61)02
%U年の第何週目か。最初の日曜日を第1週の初日とする(00-53)33
%w10進数で表した曜日。日曜日は 0 と表す(0-6)4
%W年の第何週目か。最初の月曜日を第1週の初日とする(00-53)34
%x日付の表現08/19/12
%X時刻の表現02:50:06
%y年の最後の2桁(00-99)01
%Y年2012
%Zタイムゾーンの名前または略称CDT
%%% 記号%
  • timeptr-- これは tm 構造体へのポインタです。この構造体には、以下の各部分に分解された暦時刻が含まれています:
struct tm {
   int tm_sec;         /* 秒,范围从 0 到 59                */
   int tm_min;         /* 分,范围从 0 到 59                */
   int tm_hour;        /* 小时,范围从 0 到 23                */
   int tm_mday;        /* 一月中的第几天,范围从 1 到 31                    */
   int tm_mon;         /* 月份,范围从 0 到 11                */
   int tm_year;        /* 自 1900 起的年数                */
   int tm_wday;        /* 一周中的第几天,范围从 0 到 6                */
   int tm_yday;        /* 一年中的第几天,范围从 0 到 365                    */
   int tm_isdst;       /* 夏令时                        */    
};

戻り値

生成された C 文字列が size 文字未満(終端のヌル文字を含む)の場合、str にコピーされた文字の総数(終端のヌル文字は含まない)が返されます。それ以外の場合はゼロが返されます。

例

以下の例は、strftime() 関数の使い方を示しています。

例

#include <stdio.h> #include <time.h> int main () { time_t rawtime; struct tm *info; char buffer[80]; time( &rawtime ); info = localtime( &rawtime ); strftime(buffer, 80, "%Y-%m-%d %H:%M:%S", info); printf("フォーマットされた日付 & 時刻 : |%s|\n", buffer ); return(0); }

上記のプログラムをコンパイルして実行すると、次の結果が得られます:

格式化的日期 & 时间 : |2018-09-19 08:59:07|

C 标准库 - <time.h>C標準ライブラリ - <time.h>

その他の拡張