函数
一、asctime()
二、ctime()
三、gettimeofday()
四、gmtime()
五、localtime()
六、mktime()
七、time()
一、asctime()
描述
C 库函数 char *asctime(const struct tm *timeptr) 返回一个指向字符串的指针，它代表了结构 struct timeptr 的日期和时间。功能就是将时间日期以字符串格式表示声明
char *asctime(const struct tm *timeptr)
-参数
timeptr 是指向 tm 结构的指针，包含了分解为如下各部分的日历时间：
struct tm {
int tm_sec; /* 秒，范围从 0 到 59 */
int tm_min; /* 分，范围从 0 到 59 */
int tm_hour; /* 小时，范围从 0 到 23 */
int tm_mday; /* 一月中的第几天，范围从 1 到 31 */
int tm_mon; /* 月份，范围从 0 到 11 */
int tm_year; /* 自 1900 起的年数 */
int tm_wday; /* 一周中的第几天，范围从 0 到 6 */
int tm_yday; /* 一年中的第几天，范围从 0 到 365 */
int tm_isdst; /* 夏令时 */
};
返回值
该函数返回一个 C 字符串，包含了可读格式的日期和时间信息 Www Mmm dd hh:mm:ss yyyy，其中，Www 表示星期几，Mmm 是以字母表示的月份，dd 表示一月中的第几天，hh:mm:ss 表示时间，yyyy 表示年份。实例
#include
#include
int main(int argc, const char * argv[]) {
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 = 118;
t.tm_wday = 0;
printf("%s ",asctime(&t));
return 0;
output:
Sun Mar 25 06:10:10 2018
}
二、ctime()
- 描述
C 库函数 char *ctime(const time_t *timer) 返回一个表示当地时间的字符串，当地时间是基于参数 timer。
返回的字符串格式如下： Www Mmm dd hh:mm:ss yyyy 其中，Www 表示星期几，Mmm 是以字母表示的月份，dd 表示一月中的第几天，hh:mm:ss 表示时间，yyyy 表示年份。
- 声明
char *ctime(const time_t *timer)
- 实例
#include
#include
int main(int argc, const char * argv[]) {
time_t currentTime;
time(¤tTime);//获取当前时间
char *cTime = ctime(¤tTime);//格式输出
printf("%s ",cTime);
return 0;
}
output:
Sun Dec 30 16:59:32 2018
三、gettimeofday()
描述
gettimeofday()会把目前的时间有tv 所指的结构返回，当地时区的信息则放到tz 所指的结构中。声明
头文件：#include#include
int gettimeofday (struct timeval * tv, struct timezone * tz);
- 结构定义
timeval 结构定义为：
struct timeval{
long tv_sec; //秒
long tv_usec; //微秒
};
timezone 结构定义为：
struct timezone{
int tz_minuteswest;/*格林威治时间往西方的时差*/
int tz_dsttime;/*DST 时间的修正方式*/
};
tz_dsttime所代表的状态如下
DST_NONE //不使用
DST_USA //美国
DST_AUST //澳洲
DST_WET //西欧
DST_MET //中欧
DST_EET //东欧
DST_CAN //加拿大
DST_GB //大不列颠
DST_RUM //罗马尼亚
DST_TUR //土耳其
DST_AUSTALT //澳洲(1986 年以后)
- 实例
#include
#include
#include
int main(int argc, const char * argv[]) {
struct timeval tv;
struct timezone tz;
gettimeofday(&tv, &tz);
printf("tv_sec:%ld\n",tv.tv_sec);
printf("tv_usec:%d\n",tv.tv_usec);
printf("tz_minuteswest: %d\n", tz.tz_minuteswest);
printf("tz_dsttime:%d\n", tz.tz_dsttime);
return 0;
}
output:
tv_sec:1546161083
tv_usec:280261
tz_minuteswest: -480
tz_dsttime:0
四、gmtime()
- 描述
C 库函数 struct tm *gmtime(const time_t *timer) 使用 timer 的值来填充 tm 结构，并用协调世界时（UTC）也被称为格林尼治标准时间（GMT）表示。 - 声明
struct tm *gmtime(const time_t *timer)
- 返回值
struct tm {
int tm_sec; /* 秒，范围从 0 到 59 */
int tm_min; /* 分，范围从 0 到 59 */
int tm_hour; /* 小时，范围从 0 到 23 */
int tm_mday; /* 一月中的第几天，范围从 1 到 31 */
int tm_mon; /* 月份，范围从 0 到 11 */
int tm_year; /* 自 1900 起的年数 */
int tm_wday; /* 一周中的第几天，范围从 0 到 6 */
int tm_yday; /* 一年中的第几天，范围从 0 到 365 */
int tm_isdst; /* 夏令时 */
};
- 实例
#include
#include
#define BST (+1)
#define CCT (+8)
int main(int argc, const char * argv[]) {
time_t rawtime;
struct tm *info;
time(&rawtime);
/* 获取 GMT 时间 */
info = gmtime(&rawtime );
printf("当前的世界时钟：\n");
printf("伦敦：%2d:%02d\n", (info->tm_hour+BST)%24, info->tm_min);
printf("中国：%2d:%02d\n", (info->tm_hour+CCT)%24, info->tm_min);
return(0);
}
output:
当前的世界时钟：
伦敦：10:18
中国：17:18
五、localtime()
描述
C 库函数 struct tm *localtime(const time_t *timer) 使用 timer 的值来填充 tm 结构。timer 的值被分解为 tm 结构，并用本地时区表示。声明
struct tm *localtime(const time_t *timer)
返回值
同上面的四实例
#include
#include
int main(int argc, const char * argv[]) {
time_t c_time;
struct tm *info;
time(&c_time);
info = localtime(&c_time);
printf("本地时间日期: %s",asctime(info));
return(0);
}
output:
本地时间日期: Sun Dec 30 17:27:32 2018
六、mktime()
描述
C 库函数 time_t mktime(struct tm *timeptr) 把 timeptr 所指向的结构转换为一个依据本地时区的 time_t 值。声明
time_t mktime(struct tm *timeptr)
- 实例
#include
#include
int main(int argc, const char * argv[]) {
time_t rawtime;
struct tm * timeinfo;
int year, month ,day;
const char * weekday[] = { "周日", "周一","周二", "周三","周四", "周五", "周六"};
/* 用户输入日期 */
printf ("年: "); fflush(stdout); scanf ("%d",&year);
printf ("月: "); fflush(stdout); scanf ("%d",&month);
printf ("日: "); fflush(stdout); scanf ("%d",&day);
/* 获取当前时间信息，并修改用户输入的输入信息 */
time ( &rawtime );
timeinfo = localtime ( &rawtime );
timeinfo->tm_year = year - 1900;
timeinfo->tm_mon = month - 1;
timeinfo->tm_mday = day;
/* 调用 mktime: timeinfo->tm_wday */
mktime ( timeinfo );
printf ("那一天是：%s\n", weekday[timeinfo->tm_wday]);
return(0);
}
output:
年: 2018
月: 12
日: 30
那一天是：周日
七、time()
- 头文件、声明
#include
time_t time(time_t *t);
描述
此函数会返回从公元 1970 年1 月1 日的UTC 时间从0 时0 分0 秒算起到现在所经过的秒数。如果t 并非空指针的话，此函数也会将返回值存到t 指针所指的内存。实例
#include
#include
int main(int argc, const char * argv[]) {
int seconds;
time((time_t *)&seconds);
printf("%d\n", seconds);
return(0);
}
output:
1546162914