Tzset设置时间环境变量。
void tzset(void);
例程 需要的头文件 兼容性
tzset <time.h> Win NT,Win 95
对于另外兼容性的信息,参见引言中的兼容性
库
LIBC.LIB 单线程静态库,零售版本
LIBCMT.LIB 多线程静态库,零售版本
MSVCRT.LIB MSVCRT.DLL的输入库,零售版本
返回值
无
说明
tzset函数使用环境变量TZ的当前设置把值赋给三个全局变量:
daylight,timezone和tzname。
这些变量由ftime和localtime函数使用校正格林威治(UTC)时间为本地时间,通过time函数从系统时间计算UTC,使用如下语法设置TZ环境变量:
set TZ=tzn[+|-]hh[:mm[:ss]][dzn]
tzn三字母时区名,例如PST,你必须指出本地时间距UTC的偏移量。
hhUTC与本地时间的时差,任选带符号的。
mm分钟,由冒号(:)与hh分隔开。
ss秒钟,用冒号(:)与mm分隔开。
dzn三字母夏令时时区例如PDT。如果夏令时没作用,设置TZ时不设置dzn的值。C运行库假设在计算夏令时(DST)时执行美国的规则。
例如,为了设置TZ环境为德国对应的当前时区,你可以使用如下语句之一:
set TZ=GST-1GDT
set TZ=GST+1GDT
这些字符串使用GST指出德国标准时间,假设德国是超前UTC一个小时,并假设夏令时起作用。
如果TZ值没设置,tzset试图使用操作系统指定的时区信息,在Windwos NT和Windows95之下,这个信息指定在控制面版的日期/时间应用中,如果tzset不能获取这些信息,它缺省使用PST8PDT,它指定为太平洋标准时间。
基于TZ环境变量的值,当调用tzset时把如下值赋给全局变量
daylight、timezone和tzname:
全局变量 说明 缺省值
daylight 如果在TZ设置中指定夏令时时区, 1
则为非0值;否则为0
timezone UTC和本地时间之间的时差,单位为秒 28800(28800秒等于8小时)
tzname[0]TZ环境变量的时区名称的字符串值;如果TZ未设置则为空 PST
tzname[1]夏令时时区的字符串值;如果TZ环境变量中忽略夏令时时区则为空PDT在上表中daylight和tzname数组的缺省值对应于"PST8PDT"。
如果从TZ环境变量忽略DST时区,daylight的值为0,ftime,gmtime和localtime函数对于它们的DST标志返回0。
例子/ *
TZSET.C: This program first sets up the time zone by*
placing the variable named TZ=EST5 in the environment*
table. It then uses tzset to set the global variables*
named daylight, timezone, and tzname.*/
#include <time.h>
#include <stdlib.h>
#include <stdio.h>
void main( void )
{if( putenv( "TZ=EST5EDT" ) == -1 )
{printf( "Unable to set TZ\n" );exit( 1 );
}
else
{ tzset(); printf( "daylight = %d\n", daylight );
printf( "timezone = %ld\n", timezone );
printf( "tzname[0] = %s\n", tzname[0] );
}
exit( 0 );
}
输出
daylight = 1
timezone = 18000
tzname[0] = EST
参见
asctime,ftime,gmtime,localtime,time,utime
