Retrieves the current system date and time. The system time is expressed in Coordinated Universal Time (UTC).
To retrieve the current system date and time in local time, use the GetLocalTime function.
Syntax
void WINAPI GetSystemTime(
__out LPSYSTEMTIME lpSystemTime
);
Parameters
- lpSystemTime [out]
-
A pointer to a
SYSTEMTIME structure to receive the current system date and time. The lpSystemTime parameter must not be NULL. Using NULL will result in an access violation.
Return Value
This function does not return a value or provide extended error information.
Remarks
To set the current system date and time, use the SetSystemTime function.
Examples
For an example, see
SYSTEMTIME.
Requirements
| Minimum supported client | Windows 2000 Professional |
|---|
| Minimum supported server | Windows 2000 Server |
|---|
| Header | Winbase.h (include Windows.h) |
|---|
| Library | Kernel32.lib |
|---|
| DLL | Kernel32.dll |
|---|
See Also
- GetLocalTime
- GetSystemTimeAdjustment
- GetSystemTimeAsFileTime
- SetSystemTime
- System Time
- SYSTEMTIME
- Time Functions
Send comments about this topic to Microsoft
Build date: 11/19/2009