strftime() - C語言庫函式

C庫函式 size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr) 格式表示的時間結構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 中指定的時間來表示。格式說明符：

• timeptr -- 這是為tm結構的指標，它包含一個日曆時間分解成其組成部分，如下圖所示：

struct tm {
   int tm_sec;         /* seconds,  range 0 to 59          */
   int tm_min;         /* minutes, range 0 to 59           */
   int tm_hour;        /* hours, range 0 to 23             */
   int tm_mday;        /* day of the month, range 1 to 31  */
   int tm_mon;         /* month, range 0 to 11             */
   int tm_year;        /* The number of years since 1900   */
   int tm_wday;        /* day of the week, range 0 to 6    */
   int tm_yday;        /* day in the year, range 0 to 365  */
   int tm_isdst;       /* daylight saving time             */	
};

返回值

如果C字串適合大小的字元（包括終止空字元）小於總數的字元複製到 str（不包括終止空字元），否則返回0。

例子

下面的例子演示了如何使用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("Formatted date & time : |%s|
", buffer );
  
   return(0);
}

Formatted date & time : |08/23/12 - 12:40AM|