Applies to: desktop apps | Metro style apps

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

See also

GetLocalTime

GetSystemTimeAdjustment

GetSystemTimeAsFileTime

SetSystemTime

System Time

SYSTEMTIME

Time Functions

Send comments about this topic to Microsoft

Build date: 3/6/2012