ctime64_r()- 將時間轉換為字串 (可重新啟動)

格式

#include <time.h>
char *ctime64_r(const time64_t *time, char *buf);

語言層次

ILE C 延伸

安全執行緒

是

區分語言環境

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

說明

此函數是可重新啟動的 ctime64() 函數版本。

ctime64() 函數會以字串形式將 time 所指向的時間值轉換為當地時間。通常透過呼叫 time64() 函數來取得時間值。

ctime64_r() 函數所產生的字串結果正好包含 26 個字元，其格式如下:

   "%.3s %.3s%3d %.2d:%.2d:%.2d %d\n"

例如：

   Mon Jul 16 02:03:55 1987\n\0

ctime64_r() 函數使用 24 小時制格式。使用的月和日縮寫是從語言環境擷取。所有欄位都有固定寬度。只有 1 位數的日期前面會有零。換行字元 (\n) 和空值字元 (\0) 佔據字串的最後兩個位置。

回覆值

ctime64_r() 函數會傳回字串結果的指標。如果函數不成功，則會傳回 NULL。對 ctime64_r() 函數的呼叫相當於:

   asctime_r(localtime64_r(&anytime, buf2), buf)

範例

此範例會使用 time64()來輪詢系統時鐘。然後，它會列印一則訊息，並提供現行日期和時間。

#include <time.h>
#include <stdio.h>
 
int main(void)
{
   time64_t ltime;
   char buf[50];
 
   time64(&ltime);
   printf("the time is %s", ctime64_r(&ltime, buf));
}