Cライブラリ関数 -strftime()
説明
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 |
| %H | 24時間形式の時(00-23) | 14 |
| %I | 12時間形式の時(01-12) | 05 |
| %j | 年の何日目か(001-366) | 231 |
| %m | 10進数で表した月(01-12) | 08 |
| %M | 分(00-59) | 55 |
| %p | AM または PM の名前 | PM |
| %S | 秒(00-61) | 02 |
| %U | 年の第何週目か。最初の日曜日を第1週の初日とする(00-53) | 33 |
| %w | 10進数で表した曜日。日曜日は 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>