asctime() - C語言庫函式


C庫函式 char *asctime(const struct tm *timeptr) 返回一個指標,指向一個字串,它表示的日期和時間結構struct timeptr。

宣告

以下是asctime() 函式的宣告。

char *asctime(const struct tm *timeptr)

引數

timeptr 是指向 tm結構的指標包含一個日曆時間分解成其組成部分,如下圖所示:

struct tm {
   int tm_sec;         /* seconds,  range 0 to 59          */
   int tm_min;         /* minutes, range 0 to 59           */
   int tm_hour;        /* hours, range 0 to 23             */
   int tm_mday;        /* day of the month, range 1 to 31  */
   int tm_mon;         /* month, range 0 to 11             */
   int tm_year;        /* The number of years since 1900   */
   int tm_wday;        /* day of the week, range 0 to 6    */
   int tm_yday;        /* day in the year, range 0 to 365  */
   int tm_isdst;       /* daylight saving time             */
};

返回值

這個函式返回一個C字串包含日期和時間資訊在人類可讀的格式 Www Mmm dd hh:mm:ss yyyy ,Www 是工作日, Mmm 是月份的字母, dd 是月份中的日期, hh:mm:ss 是時間,  yyyy 是年份.

例子

下面的例子顯示asctime() 函式的用法。

#include <stdio.h>
#include <string.h>
#include <time.h>

int main()
{
   struct tm t;

   t.tm_sec    = 10;
   t.tm_min    = 10;
   t.tm_hour   = 6;
   t.tm_mday   = 25;
   t.tm_mon    = 2;
   t.tm_year   = 89;
   t.tm_wday   = 6;

   puts(asctime(&t));
   
   return(0);
}

讓我們編譯和執行上面的程式,這將產生以下結果:

Sat Mar 25 06:10:10 1989