C語(yǔ)言 庫(kù)函數(shù) strftime()

C語(yǔ)言 標(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 中。

1. 聲明

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

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

2. 參數(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í)						*/	
};

3. 返回值

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

4. 實(shí)例

下面的實(shí)例演示了 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,"%x - %I:%M%p", info);
   printf("格式化的日期 & 時(shí)間 : |%s|\n", buffer );
  
   return(0);
}

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

格式化的日期 & 時(shí)間 : |08/23/12 - 12:40AM|

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