C 庫函數 - strftime()

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

描述

C 庫函數 size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr) 根據 format 中定義的格式化規則，格式化結構 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 中所指定時間的相對應值。格式說明符是：
說明符替換為實例
%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十進位數表示的月份（01-12）08
%M分（00-59）55
%pAM 或 PM 名稱PM
%S秒（00-61）02
%U一年中的第幾周，以第一個星期日作為第一周的第一天（00-53）33
%w十進位數表示的星期幾，星期日表示為 0（0-6）4
%W一年中的第幾周，以第一個星期一作為第一周的第一天（00-53）34
%x日期表示法08/19/12
%X時間表示法02:50:06
%y年份，最後兩個數字（00-99）01
%Y年份2012
%Z時區的名稱或縮寫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 起的年數                */
   int tm_wday;        /* 一周中的第幾天，範圍從 0 到 6                */
   int tm_yday;        /* 一年中的第幾天，範圍從 0 到 365                    */
   int tm_isdst;       /* 夏令時                        */    
};

返回值

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

實例

下麵的實例演示了 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, "%Y-%m-%d %H:%M:%S", info);
   printf("格式化的日期 & 時間 : |%s|\n", buffer );

   return(0);
}

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

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

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