Windows中的时间(SYSTEMTIME和FILETIME)

上一篇中介绍了C运行库中的时间处理函数。这一篇介绍Windows SDk中提供的时间函数。两种时间系统之间没有本质区别(事实上CRT时间是用Windows时间实现的，当然这是说的VC实现)，同样提供本地时间和UTC时间之间的转换。不过CRT中的tm时间在SDK中对应为系统时间(SYSTEMTIME)，CRT中的time_t时间在SDK中对应的为文件时间(FILETIME)，那个"特殊时刻"也变成1601年1月1日的子夜。

    当然，首先要弄清楚FILETIME与SYSTEMTIME定义。

   

[cpp]  view plain copy

1. typedef struct _FILETIME {  
2.                           DWORD dwLowDateTime;  
3.                           DWORD dwHighDateTime;  
4. } FILETIME, *PFILETIME;  
5. typedef struct _SYSTEMTIME {  
6.                             WORD wYear;  
7.                             WORD wMonth;  
8.                             WORD wDayOfWeek;  
9.                             WORD wDay;  
10.                             WORD wHour;  
11.                             WORD wMinute;  
12.                             WORD wSecond;  
13.                             WORD wMilliseconds;  
14. } SYSTEMTIME, *PSYSTEMTIME;  

    比较一下，很明显，FILETIME与time_t类似，是64位整型，不过FILETIME是以100纳秒(ns)为单位。SYSTEMTIME与tm类似，不过多了一项wMilliseconds。可以看出，SDK时间比CRT的时间提供了更高的精度。同时SDK提供了更丰富的函数来处理时间。

   

[c-sharp]  view plain copy

1. void GetSystemTime(  
2.                    LPSYSTEMTIME lpSystemTime);  
3. void GetLocalTime(  
4.                   LPSYSTEMTIME lpSystemTime);  

    这两个函数获得SYSTEMTIME形式的当前时间，不过GetSystemTime函数获得当前的UTC时间，GetLocalTime获得当前的本地时间，可以想象，获得的两个时间存在着时差。类似于CRT中提供tm与time_t之间的转换，SDK也提供了两个函数来转换SYSTEMTIME时间与FILETIME时间。

   

[cpp]  view plain copy

1. BOOL SystemTimeToFileTime(  
2.                           const SYSTEMTIME* lpSystemTime,  
3.                           LPFILETIME lpFileTime);  
4. BOOL FileTimeToSystemTime(  
5.                           const FILETIME* lpFileTime,  
6.                           LPSYSTEMTIME lpSystemTime);  

    函数命名很self-explanatory，就不用多说了吧。

    SDK还提供了两个很有趣的函数。

   

[cpp]  view plain copy

1. BOOL LocalFileTimeToFileTime(  
2.                              const FILETIME* lpLocalFileTime,  
3.                              LPFILETIME lpFileTime);  
4. BOOL FileTimeToLocalFileTime(  
5.                              const FILETIME* lpFileTime,  
6.                              LPFILETIME lpLocalFileTime);  

    LocalFileTimeToFileTime函数将本地的FILETIME时间转换为对应的UTC的FILETIME时间。我觉得，这个函数只是通过将本地时间减去与UTC时间的时间差来实现转换，比如在东八区的本地时间转换为对应的UTC时间，只需要将本地时间减去8*60*60*1000*1000*10(单位100ns)。类似，FileTimeToLocalFileTime函数是将UTC时间转换为本地时间，它只是将减去时间差换成加上时间差。

    了解了这些功能，让我们用代码说话吧。

   

[cpp]  view plain copy

1. #include <stdlib.h>  
2. #include <stdio.h>  
3. #include <time.h>  
4. #include <windows.h>  
5.   
6.   
7. int main()  
8. {  
9.     SYSTEMTIME      stLocal, stUTC, stUTC2;  
10.     FILETIME        ftLocal, ftUTC, ft;  
11.     ULARGE_INTEGER  uli;  
12.   
13.     GetLocalTime(&stLocal);  
14.     GetSystemTime(&stUTC);  
15.     printf("Local System Time(YYYY-MM-DD HH:MM:SS): %d-%d-%d %d:%d:%d/n", stLocal.wYear, stLocal.wMonth,  
16.         stLocal.wDay, stLocal.wHour, stLocal.wMinute, stLocal.wSecond);  
17.     printf("UTC System Time  (YYYY-MM-DD HH:MM:SS): %d-%d-%d %d:%d:%d/n", stUTC.wYear, stUTC.wMonth,  
18.         stUTC.wDay, stUTC.wHour, stUTC.wMinute, stUTC.wSecond);  
19.   
20.     SystemTimeToFileTime(&stLocal, &ftLocal);  
21.     uli.LowPart = ftLocal.dwLowDateTime;  
22.     uli.HighPart = ftLocal.dwHighDateTime;  
23.     printf("Local File Time: %llu/n", uli.QuadPart);  
24.   
25.     LocalFileTimeToFileTime(&ftLocal, &ftUTC);  
26.     uli.LowPart = ftUTC.dwLowDateTime;  
27.     uli.HighPart = ftUTC.dwHighDateTime;  
28.     printf("UTC File Time: %llu/n", uli.QuadPart);  
29.   
30.     FileTimeToSystemTime(&ftUTC, &stUTC2);  
31.     printf("UTC System Time2 (YYYY-MM-DD HH:MM:SS): %d-%d-%d %d:%d:%d/n", stUTC2.wYear, stUTC2.wMonth,  
32.         stUTC2.wDay, stUTC2.wHour, stUTC2.wMinute, stUTC2.wSecond);  
33.   
34.     return EXIT_SUCCESS;  
35. }  

    程序输出结果如下：

    

    代码13行GetLocalTime函数获得当前的本地SYSTEMTIME时间，14行获得对应的UTC的SYSTEMTIME时间，如输出结果前两行所显示，两者相差8小时(凌晨还在写博客，表扬下自己。。。)。

    20行SystemTimeToFileTime函数将本地SYSTEMTIME时间转换为方便计算的本地FILETIME形式时间，如输出结果第三行所显示。

    25行LocalFileTimeToFileTime函数将本地FileTime时间转换为对应的UTC的FILETIME时间，如输出结果第四行所显示。就像前面介绍的，如果你将输出结果第三，四两行所显示的数字相减，并除以10*1000*1000*60*60，你将会得出8，你可以算下试试，记住FILETIME是以100纳秒为单位的。

    最后30行FileTimeToSystemTime将FILETIME时间转换为SYSTEMTIME时间。可以看出输出结果中第五行与第二行相同，这是必须的，因为两者都是当前本地时间对应的UTC时间。