SYSTEMTIME 结构

小甲鱼

注：本文档由 Diu 翻译，小甲鱼校对。

原文链接 -> 传送门

SYSTEMTIME 结构

SYSTEMTIME 结构指定日期与时间，月，天，年，星期，小时，分钟，秒和毫秒，都是用单独的成员表示。该时间要么是世界标准时间（UTC），要么是本地时间（取决于正在被调用的函数）。


结构原型：

1. typedef struct _SYSTEMTIME {
   
2.   WORD wYear;
   
3.   WORD wMonth;
   
4.   WORD wDayOfWeek;
   
5.   WORD wDay;
   
6.   WORD wHour;
   
7.   WORD wMinute;
   
8.   WORD wSecond;
   
9.   WORD wMilliseconds;
   
10. } SYSTEMTIME, *PSYSTEMTIME;

复制代码

成员解析：

成员	含义
wYear	年。该成员的有效值从 1601 到 30827
wMonth	月。该成员是下列值中的某一个： 值 含义 1 一月份 2 二月份 3 三月份 4 四月份 5 五月份 6 六月份 7 七月份 8 八月份 9 九月份 10 十月份 11 十一月份 12 十二月份
wDayOfWeek	星期。该成员是下列值中的某一个： 值 含义 0 星期天 1 星期一 2 星期二 3 星期三 4 星期四 5 星期五 6 星期六
wDay	一个月中的某一天。该成员的有效值从 1 到 31
wHour	小时。该成员的有效值从 0 到 23
wMinute	分钟。该成员的有效值从 0 到 59
wSecond	秒。该成员的有效值从 0 到 59
wMilliseconds	毫秒。该成员的有效值从 0 到 999

备注：

1. 不建议你通过对 SYSTEMTIME 结构中的值进行加和减来获取相对时间。取而代之，你应该：

• 将 SYSTEMTIME 结构转换为 FILETIME 结构。
• 将产生的 FILETIME 结构拷贝到 ULARGE_INTEGER 结构。
• 对 ULARGE_INTEGER 值进行正常的 64 位算术运算。
  

2. 系统可以通过与时间源同步来定期刷新时间。由于系统时间既可以向前又可以向后调整，所以不要比较系统的时间读数以确定运行时间。相反，使用 Windows Time 中描述的方法。


例子：

下边的例子演示使用 GetSystemTime 和 GetLocalTime 函数获取不同的时间值。

1. #include <windows.h>
   
2. #include <stdio.h>
   
3. 
   
4. void main()
   
5. {
   
6.     SYSTEMTIME st, lt;
   
7.    
   
8.     GetSystemTime(&st);
   
9.     GetLocalTime(&lt);
   
10.    
    
11.     printf("The system time is: %02d:%02d\n", st.wHour, st.wMinute);
    
12.     printf(" The local time is: %02d:%02d\n", lt.wHour, lt.wMinute);
    
13. }

复制代码

样本输出：

1. The system time is: 19:34
   
2. The local time is: 12:34

复制代码

需求：

Minimum supported client	Windows 2000 专业版 [仅桌面应用程序]
Minimum supported server	Windows 2000 服务器版 [仅桌面应用程序]
Header	Winbase.h (包含于 Windows.h)

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。