39 - ctime()函数

1 函数原型

ctime()：时间类型转换，函数原型如下：

char* ctime (const time_t * timer);

ctime库描述如下：

Convert time_t value to string
1. Interprets the value pointed by timer as a calendar time and converts it to a C-string containing a human-readable version of the corresponding time and date, in terms of local time.
2. The returned string has the following format:
           Www Mmm dd hh:mm:ss yyyy
   Where Www is the weekday, Mmm the month (in letters), dd the day of the month, hh:mm:ss the time, and yyyy the year.
3. The string is followed by a new-line character ('\n') and terminated with a null-character.
4. This function is equivalent to:
           asctime(localtime(timer))
5. For an alternative with custom date formatting, see strftime.

1. ctime()函数：
   （1）用于将time_t类型的时间值转换为可读的字符串；
   （2）字符串包含表示本地时间的日期和时间信息，格式是固定的：“Www Mmm dd hh:mm:ss yyyy”+“\n\0”，共26个字符，各部分含义如下：

Www ：星期几的缩写（例如，Mon 表示星期一，Tue 表示星期二，依此类推）。
Mmm ：月份的缩写（例如，Jan 表示一月，Feb 表示二月，依此类推）。
dd  ：月份中的日期，范围从 01 到 31。
hh  ：小时，范围从 00 到 23（24小时制）。
mm  ：分钟，范围从 00 到 59。
ss  ：秒，范围从 00 到 59。
yyyy：四位数的年份（例如，2023）。

2 参数

ctime()函数只有一个参数timer：

1. 参数timer是一个指向time_t类型对象的指针，类型为time_t*；timer指向的对象包含要转换的时间值。

ctime库描述如下：

timer
1. Pointer to an object of type time_t that contains a time value.
2. time_t is an alias of a fundamental arithmetic type capable of representing times as returned by function time.

3 返回值

ctime()函数的返回值类型为char*型：

1. 转换成功，返回一个指向静态字符串的指针，该字符串包含表示本地时间的日期和时间信息。

ctime库描述如下：

1. A C-string containing the date and time information in a human-readable format.
2.The returned value points to an internal array whose validity or value may be altered by any subsequent call to asctime or ctime.

4 示例

示例代码如下所示：

int main() {
   //
   time_t current_time = 0;
   char* time_string = NULL;
   // 获取当前时间
   current_time = time(NULL);
   // 将时间值转换为字符串
   time_string = ctime(&current_time);
   // 打印当前时间
   printf("当前时间 : %s", time_string);
   //
   return 0;
}

代码运行结果如下图所示：