C語言 庫函數 strftime()

C語言 標準庫 - <time.h>

C 庫函數 size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr) 根據 format 中定義的格式化規則，格式化結構 timeptr 表示的時間，并把它存儲在 str 中。

1. 聲明

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

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

2. 參數

• str -- 這是指向目標數組的指針，用來復制產生的 C 字符串。
• maxsize -- 這是被復制到 str 的最大字符數。
• format -- 這是 C 字符串，包含了普通字符和特殊格式說明符的任何組合。這些格式說明符由函數替換為表示 tm 中所指定時間的相對應值。格式說明符是：

• 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;       /* 夏令時						*/	
};

3. 返回值

如果產生的 C 字符串小于 size 個字符（包括空結束字符），則會返回復制到 str 中的字符總數（不包括空結束字符），否則返回零。

4. 實例

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

讓我們編譯并運行上面的程序，這將產生以下結果：

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

C語言 標準庫 - <time.h>