strftime

引數

ptr

指向結果 C 字串的儲存區的指標。

maxsize

ptr 中可複製的最大字元數，包括終止的空字元。

format

C 字串，包含任意組合的普通字元和特殊格式說明符。這些格式說明符將被函式替換為 timeptr 指定時間的相應值。它們都以百分號 (%) 開始，具體如下：

說明符	替換為	示例
%a	星期縮寫名稱 *	週四
%A	星期全稱 *	星期四
%b	月份縮寫名稱 *	八月
%B	月份全稱 *	八月
%c	日期和時間表示 *	2001年8月23日星期四 14:55:02
%C	年份除以 100 並截斷為整數 (00-99)	20
%d	月份的第幾天，零填充 (01-31)	23
%D	簡寫 MM/DD/YY 日期，等同於 %m/%d/%y	08/23/01
%e	月份的第幾天，空格填充 ( 1-31)	23
%F	簡寫 YYYY-MM-DD 日期，等同於 %Y-%m-%d	2001-08-23
%g	基於周的年份，最後兩位數字 (00-99)	01
%G	基於周的年份	2001
%h	月份縮寫名稱 * (與 %b 相同)	八月
%H	24 小時制的小時 (00-23)	14
%I	12 小時制的小時 (01-12)	02
%j	一年中的第幾天 (001-366)	235
%m	月份的十進位制數 (01-12)	08
%M	分鐘 (00-59)	55
%n	換行符 ('\n')
%p	上午或下午的標識	下午
%r	12 小時制時鐘時間 *	02:55:02 下午
%R	24 小時制 HH:MM 時間，等同於 %H:%M	14:55
%S	秒 (00-61)	02
%t	水平製表符 ('\t')
%T	ISO 8601 時間格式 (HH:MM:SS)，等同於 %H:%M:%S	14:55:02
%u	ISO 8601 星期幾，以週一為 1 (1-7)	4
%U	週數，以第一個星期日為第一個星期一的第一天 (00-53)	33
%V	ISO 8601 週數 (01-53)	34
%w	星期幾的十進位制數，以週日為 0 (0-6)	4
%W	週數，以第一個星期一為第一個星期一的第一天 (00-53)	34
%x	日期表示 *	08/23/01
%X	時間表示 *	14:55:02
%y	年份，最後兩位數字 (00-99)	01
%Y	年份	2001
%z	ISO 8601 時區與 UTC 的偏移量 (1 分鐘=1，1 小時=100) 如果無法確定時區，則不輸出任何字元	+100
%Z	時區名稱或縮寫 * 如果無法確定時區，則不輸出任何字元	CDT
%%	一個百分號 (%)	%

* 標有星號 (*) 的說明符是區域設定相關的。
注意：黃色行表示 C99 引入的說明符和子說明符。自 C99 起，兩個與區域設定相關的修飾符也可以插入在百分號 (%) 和說明符本身之間，以便在適用時請求替代格式。

修飾符	含義	適用於
E	使用區域設定的替代表示法	%Ec %EC %Ex %EX %Ey %EY
O	使用區域設定的替代數字符號	%Od %Oe %OH %OI %Om %OM %OS %Ou %OU %OV %Ow %OW %Oy

timeptr

指向一個 tm 結構體的指標，該結構體包含一個分解為其各組成部分的日曆時間（請參見 struct tm）。

返回值

相容性

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

/* strftime example */
#include <stdio.h>      /* puts */
#include <time.h>       /* time_t, struct tm, time, localtime, strftime */

int main ()
{
  time_t rawtime;
  struct tm * timeinfo;
  char buffer [80];

  time (&rawtime);
  timeinfo = localtime (&rawtime);

  strftime (buffer,80,"Now it's %I:%M%p.",timeinfo);
  puts (buffer);

  return 0;
}

Now it's 03:21PM.

資料競爭

異常 (C++)

另見

ctime

將 time_t 值轉換為字串 (函式)

asctime

將 tm 結構體轉換為字串 (函式)