TIME

 

标准库函数除了定义一些处理日期和时间的函数外，还定义了处理与程序有关的地理信息的函数。对这些函数讨论如下。

     时间和日期函数需要头部<time.h>。这个头部定义了三种与时间有关的类型：clock_t,time_t,tm。类型clock_t和time_t可以用长整数表示系统时间和日期，称为日历时。结构类型tm保存分解为相应元素的日期和时间。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; 天数（从1月开始），0~365
int tm_isdst; 夏令时指示器

    实行夏令时的时候，tm_isdst为正。不实行夏令时的进候，tm_isdst为0；不了解情况时，tm_isdst()为负，ANSI C标准称这种表示为分解时(broken-down time)。此外，<time.h>中定义了宏CLOCK_SPER_SEC，它表示系统时钟每秒嘀嗒的次数。地理环境函数需要头部<locale.h>，它定义了结构lconv。

1.asctime
#inlcude <time.h>
char *asctime(const struct tm *ptr);


函数返回指向一个串的指针，其中保存ptr所指结构中存储的信息变换形式，具体格式如下：
day month date hour:minutes:seconds year/n/0
例如：Fri Apr 15 12:05:34 2005

由ptr指向的结构一般是通过调用localtime()或gmttime()香到的。

保存asctime()返回的格式化时间串空间是静态变量。因此每次调用asctime()时都用新串冲掉该静态字符数组中的原值。希望保存以前的结果时，应该把它复制到别处。

例子：显示系统定义的本地时间。

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

int main(void)
{
struct tm *ptr;
time_t lt;

lt =time(NULL);
ptr=localtime(&lt);
printf(asctime(ptr));

return 0;
}

2. clock
#include <time.h>
clock_t clock(void);

函数clock()返回近似行于调用程序运行时间量的值，该值除以CLOCKS_PER_SEC后转换为秒数。返回-1值表示无法取得系统时间。

例子：显示程序调用它所需的当前执行时间。

void elapsed_time()
{
printf("Elapsed time:%u secs./n",clock()/CLOCKS_PER_SEC);
}

3. ctime

# include <time.h>
char *ctime(const time_t *time);

如果指针指向日历时间的话，则ctime()返回一指针到形式为如下所示的串：
day month year hours:minutes:seconds year /n/0

日历时一般通过调用time()取得。
ctime()放置格式化的输出字符串所用的缓冲区是静态分配的字符数组，每次该函数调用时都重写。如果希望保存该串的内容,应该把它拷贝到其它地方。

例子：显示系统定义的本地时间

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

int main(void)
{
time_t lt;

lt = time(NULL);
printf(ctime(&lt);

return 0;
}

4.difftime

#include <time.h>
double difftime(time_t time2,time_t time1);

函数difftime()以秒为单位，返回time2-time1的差.

例子：统计5000000次空的FOR循环的时间，单位为秒。

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

int main(void)
{
time_t start,end;
volatile long unsigned t;

start = time(NULL);
for(t= 0;t<5000000;t++);
end = time(NULL);
printf("Loop used %f seconds./n",difftime(end,start));

return-;
}

5.gmtime
#include <time.h>
struct tm *gmtime(const time_1 *time);

函数gmtime()返回一个指针，指针指向以tm结构形式的分解形式time。时间用UTC即格林尼治时间表示，time4指针一般通过调用time()取得。如果系统不支持UTC，则该函数返回空指针。
gmtime()用来保存分解时间的结构变量是静态分配的，每次调用gmtime()时都重写。希望保存结构的内容时，必须把它拷贝到其他地方。

例子：既输出系统的本地时间，也输出系统的UTC时间。

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

int main(void)
{
struct tm *local,*gm;
time_t t;

t=time(NULL);
local = localtime(&t);
printf("Local time and date:%s/n",asctime(local));
gm=gmtime(&t);
printf("CUT and date:%s",asctime(gm));

return 0;
}

6.localeconv

#include <locale.h>
struct lconv *localeconv(void);

函数localeconv()返回指向结构类型lconv的指针，其中包含大量的地理环境信息，这些信息与格式化的道路号有关。

例子：显示当前定域所使用权用的十进制小数点字符。

#include <stdio.h>
#include <locale.h>

int main()
{
struct lconv lc;

lc= *localeconv();
pirntf("Decimal symbol is:%s/n",lc.decimal_point);

return 0;
}

7.localtime

#include <time.h>
struct tm *localtime(const time_t *time);

函数localtime()返回指向以tm结构形式的分解形式time的一个指针。该时间表示为本地时间。time指针一般通过调用 time()取得。
localtime()用于保存分解时间的结构变量是静态分配的，每次调用时都重写。因此希望保存这个结构的内容时，应该在再次调用之前先拷贝到其他地方。

例子：输出系统的本地时间和UTC时间。

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

int main(void)
{
struct tm *local;
time_t t;

t=timw(NULL);
local=localtime(&t);
printf("Local time and date :%s/n",asctime(local));
local=gmtime(&t);
printf("UTC time and date :%s/n",asctime(local));

return 0;
}

8.mktime

#include <time.h>
time_t mktime(struct tm *time);

mktime()返回time所指的结构变量中找到的分解时间等价的日历时。元素tm_wday和tm_yday由该函数设置，因此调用时不必定义。
如果 mktime()不能把信息表示为合法日历时，则返回-1。

例子：显示2005年1月3日是星期几。

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

int main(void)
{
stuct tm t;
time_t t_of_day;

t.tm_year=2005-1900;
t.tm_mon=0;
t.tm_mday=3;
t.tm_hour=0;
t.tm_min=0;
t.tm_sec=1;
t.tm_isdst=0;

t_of_day=mktime(&t);
printf(ctime(&t_of_day));

return 0;
}

9.setlocale

#include <locale.h>
char *setlocale(int type,const char *locale);

函数setlocale()用于查询和设置某些参数，它们与和序执行的地理环境有关。
如果 locale为空指针，则setlocale()返回一个指针，指向当前本地化信息串；否则，setlocale()试用locale串中的本地化信息按type的说明设置本地化参数。
要指定标准的 C的场所(local)，请使用串"C"；要指定本地环境，请使用空串" "。关于它所支持的本地化串，请参阅自已的编译程序文档。
调用时，type必须取下列的宏之一（在<locale.h>中定义）：

LC_ALL
LC_COLLATE
LC_CTYPE
LC_MONETARY
LC_NUMERIC
LC_TIME

LC_ALL代表所有本地化类别。LC_COLLATE影响函数strcoll()的操作。LC_CTYPE改变字符函数的工作方法。LC_MONETARY确定货币的格式。LC_NUMERIC改用输出/输入函数所用的十进制小数点符号。LC_TIME决定函数strftime()的行为。
函数setlocale()返回一个指针，指向与type参数关联的一个串。

例子：显示当前的本地设置

#include <locale.h>
#include <stdio.h>

int main(void)
{
printf(setlocale(LC_ALL," "));

return 0;
}

10. strftime

#include <time.h>
size_t strftime(char *str,size_t maxsize,const char *fmt,const struct tm *time);

函数strftime()根据fmt指向的串中的格式命令以及使用time指向的分解时间，把时间，日期信息与其他信息放在str指向串中。最多向str中放maxsize个字符。
在 C99中，str、fmt及time由restrict修饰。
函数 strftime()的操作有些类似于sprintf():识别以百分号(%)开始的格式命令集合，格式化输出结果放在一个串中。格式化命令说明串str各种日期和时间信息的确切表示方法。格式串中的其他字符原样放进串中。日期和时间性按本地时间显示。格式命令列在下表中，显然它们是区分大小写的。

命令替换为
%a 星期几的简写
%A 星期几的全称
%b 月分的简写
%B 月份的全称
%c 标准的日期
%C标准的时间串
%d 十进制表示的每月的第几天
%D 月/天/年
%e 在两字符域中，十进制表示的每月的第几天
%F 年-月-日
%g 年份的后两位数字，使用基于周的年
%G 年分，使用基于周的年
%h 简写的月份名
%H 小时（24）
%I 小时（12）
%j 十进制表示的每年的第几天
%m 十进制表示的月份
%M 十时制表示的分钟数
%n 新行符
%p 本地的AM或PM的等价显示
%r 12小时的时间
%R hh:mm
%S 十进制的秒数
%t 水平制表符
%T hh:mm:ss
%u 每周的第几天，星期一为第一天
%U 第年的第几周，星期日为第一天
%V 每年的第几周，使用基于周的年
%w 十进制表示的星期几
%W 每年的第几周，星期一为第一天
%x 标准的日期串
%X 标准的时间串
%y 不带世纪的十进制年份
%Y 带世纪部分的十制年份
%z与UTC的偏差
%Z 时区名称
%% 百分号

C99允许用E或修改某些格式strftime()命令。E可以修改c,C,x,X,y,Y,d,e和H，O可以修改I,m,M,S,u ,U,V,w,W和y.这些修饰符必变了时间和/或日期的显示方式。
基于周的年用于%g,%G和%V格式命令。根据这一表示方法，星期一为每周的第一天，而第年的第一周必须包括1月4日。

例子：假设LTIME指向的包含“10：00：00 AM”的结构，以下代码将输出“it is now 10AM".

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

int main(void)
{
struct tm *ptr;
time_t lt;
char str[80];

lt=time(NULL);
ptr=localtime(&lt);

strftime(str,100,"It is now %H %p",ptr);
printf(str);

return 0;
}

11.time
#include <time.h>
time_t time(time_t *time);

函数time()返回系统的当前日历时间，如系统和丢失时间设置，函数返回-1。
对函数 time_t的调用，既可用空指针，也可以使用指向time_t类型变量的指针。如果使用字母，则该变量也可赋予日历时间。

例子：显示系统定义的本地时间。

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

int main(void)
{
struct tm *ptr;
time_t lt;

lt = time(NULL);
ptr=localtime(&lt);
printf(asctime(ptr));

return 0;
}
12、Difftime

找出两个时间差。
double difftime(timet timer1,timet timer0);
#include <stdio.h>
#include <stdlib.h>
#include <time.h>
void main( void )
{
timetstart, finish;
long loop;
double result, elapsedtime;
printf( "Multiplying 2 floating point numbers 10 million times...＼n" );
time( &start );
or( loop = 0; loop < 10000000; loop++ )
result = 3.63 * 5.27;
time( &finish );
elapsedtime = difftime( finish, start );
printf( "＼nProgram takes %6.0f seconds.＼n", elapsedtime );
}
输出结果
Multiplying 2 floats 10 million times...
Program takes2 seconds.