strftime ()- 將日期/時間轉換成字串

格式

#include <time.h>
size_t strftime(char *s, size_t maxsize, const char *format,
                   const struct tm *timeptr);

語言層次

ANSI

安全執行緒

是

區分語言環境

此函數的行為可能受現行語言環境的 LC_CTYPE、LC_TIME 及 LC_TOD 種類影響。 如需相關資訊，請參閱 瞭解 CCSID 及語言環境。

說明

strftime() 函數會將位元組放入 s 所指向的陣列中，如 format所指向的字串所控制。 格式字串由零或多個轉換規格及一般字元組成。 轉換規格由% 字元和終止轉換字元組成，可決定轉換的行為。 所有一般字元 (包括終止空值位元組及多位元組字元) 都會依原樣複製到陣列中。 如果在重疊的物件之間進行複製，則未定義行為。 陣列中放置的位元組數不超過 maxsize 個。 適當的字元由 timeptr所指向結構中包含的值以及現行語言環境中儲存的值來決定。

已修改轉換指定元

部分轉換指定元可以由 E 或 O 修飾元字元修改，以指出應該使用替代格式或規格，而不是未修改轉換指定元通常使用的格式或規格。 如果已修改的轉換指定元使用現行語言環境中無法使用的欄位，則行為會如同使用未修改的轉換規格一樣。 例如，如果 era 字串是空字串 "" ，這表示字串無法使用，則 %EY 會像 %Y 一樣。

回覆值

如果產生的位元組總數 (包括終止空值位元組) 不超過 maxsize ，則 strftime() 會傳回放入 s所指向陣列中的位元組數 (不包括終止空值位元組)。 否則，會傳回 0 ，且陣列內容不確定。

範例

#include <stdio.h>
#include <time.h>
 
int main(void)
{
     char s[100];
     int rc;
     time_t temp;
     struct tm *timeptr;

     temp = time(NULL);
     timeptr = localtime(&temp);

     rc = strftime(s,sizeof(s),"Today is %A, %b %d.\nTime:  %r", timeptr);
     printf("%d characters written.\n%s\n",rc,s);

     return 0;
}

/*************************************************
     The output should be similar to:
     46 characters written
     Today is Wednesday, Oct 24.
     Time:  01:01:15 PM
************************************************************/

相關資訊