C 庫函數(shù) - strftime()

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

描述

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

聲明

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

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

參數(shù)

  • str -- 這是指向目標數(shù)組的指針，用來復制產(chǎn)生的 C 字符串。
  • maxsize -- 這是被復制到 str 的最大字符數(shù)。
  • format -- 這是 C 字符串，包含了普通字符和特殊格式說明符的任何組合。這些格式說明符由函數(shù)替換為表示 tm 中所指定時間的相對應值。格式說明符是：
說明符替換為實例
%a縮寫的星期幾名稱 Sun
%A完整的星期幾名稱 Sunday
%b縮寫的月份名稱 Mar
%B完整的月份名稱 March
%c日期和時間表示法 Sun Aug 19 02:56:02 2012
%d一月中的第幾天（01-31）19
%H24 小時格式的小時（00-23）14
%I12 小時格式的小時（01-12）05
%j一年中的第幾天（001-366）231
%m十進制數(shù)表示的月份（01-12）08
%M分（00-59）55
%pAM 或 PM 名稱PM
%S秒（00-61）02
%U一年中的第幾周，以第一個星期日作為第一周的第一天（00-53）33
%w十進制數(shù)表示的星期幾，星期日表示為 0（0-6）4
%W一年中的第幾周，以第一個星期一作為第一周的第一天（00-53）34
%x日期表示法08/19/12
%X時間表示法02:50:06
%y年份，最后兩個數(shù)字（00-99）01
%Y年份2012
%Z時區(qū)的名稱或縮寫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 起的年數(shù)				*/
   int tm_wday;        /* 一周中的第幾天，范圍從 0 到 6		        */
   int tm_yday;        /* 一年中的第幾天，范圍從 0 到 365	                */
   int tm_isdst;       /* 夏令時						*/	
};

返回值

如果產(chǎn)生的 C 字符串小于 size 個字符（包括空結束字符），則會返回復制到 str 中的字符總數(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("格式化的日期 & 時間 : |%s|\n", buffer );
  
   return(0);
}

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

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

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