C 庫(kù)函數(shù) strftime() 使用方法及示例

C 標(biāo)準(zhǔn)庫(kù) - <time.h>

C 庫(kù)函數(shù) size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr) 根據(jù) format 中定義的格式化規(guī)則，格式化結(jié)構(gòu) timeptr 表示的時(shí)間，并把它存儲(chǔ)在 str 中。

聲明

下面是 strftime() 函數(shù)的聲明。

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

參數(shù)

• str -- 這是指向目標(biāo)數(shù)組的指針，用來(lái)復(fù)制產(chǎn)生的 C 字符串。
• maxsize -- 這是被復(fù)制到 str 的最大字符數(shù)。
• format -- 這是 C 字符串，包含了普通字符和特殊格式說(shuō)明符的任何組合。這些格式說(shuō)明符由函數(shù)替換為表示 tm 中所指定時(shí)間的相對(duì)應(yīng)值。格式說(shuō)明符是：

• timeptr -- 這是指向 tm 結(jié)構(gòu)的指針，該結(jié)構(gòu)包含了一個(gè)唄分解為以下各部分的日歷時(shí)間：

struct tm {
   int tm_sec;         /* 秒，范圍從 0 到 59                */
   int tm_min;         /* 分，范圍從 0 到 59                */
   int tm_hour;        /* 小時(shí)，范圍從 0 到 23                */
   int tm_mday;        /* 一月中的第幾天，范圍從 1 到 31                    */
   int tm_mon;         /* 月份，范圍從 0 到 11                */
   int tm_year;        /* 自 1900 起的年數(shù)                */
   int tm_wday;        /* 一周中的第幾天，范圍從 0 到 6                */
   int tm_yday;        /* 一年中的第幾天，范圍從 0 到 365                    */
   int tm_isdst;       /* 夏令時(shí)                        */    
};

返回值

如果產(chǎn)生的 C 字符串小于 size 個(gè)字符（包括空結(jié)束字符），則會(huì)返回復(fù)制到 str 中的字符總數(shù)（不包括空結(jié)束字符），否則返回零。

在線示例

下面的示例演示了 strftime() 函數(shù)的用法。

#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("格式化的日期 & 時(shí)間 : |%s|\n", buffer );
  
   return(0);
}

讓我們編譯并運(yùn)行上面的程序，這將產(chǎn)生以下結(jié)果：

格式化的日期 & 時(shí)間 : |2018-09-19 08:59:07|

C 標(biāo)準(zhǔn)庫(kù) - <time.h>