GetTimeFormatEx 函数是 Windows API 中的一个函数,用于获取时间的格式化字符串。它支持更多的定制选项。以下是该函数的一般形式和一些参数的说明:
int GetTimeFormatEx(
  LPCWSTR            lpLocaleName,
  DWORD              dwFlags,
  const SYSTEMTIME *lpTime,
  LPCWSTR            lpFormat,
  LPWSTR             lpTimeStr,
  int                cchTime
);

参数说明:

  •  lpLocaleName:指定一个 Locale 名称,用于指定时间的语言和格式规则。

  •  dwFlags:指定格式化的时间标志。可以是时间格式选项的组合,例如 TIME_FORCE24HOURFORMAT 或 TIME_NOSECONDS。

  •  lpTime:指向 SYSTEMTIME 结构的指针,包含要格式化的时间。

  •  lpFormat:一个以 null 结尾的宽字符字符串,指定自定义时间格式。可以为 NULL,表示使用默认格式。

  •  lpTimeStr:接收格式化时间字符串的缓冲区。

  •  cchTime:缓冲区的大小,以字符数为单位。


函数返回值为生成的时间字符串的长度,不包括 null 终止符,如果出现错误则返回 0。

以下是一个简单的示例,演示如何使用 GetTimeFormatEx 函数:
#include <windows.h>
#include <stdio.h>

int wmain() {
    SYSTEMTIME st;
    GetLocalTime(&st);

    WCHAR szTime[50];
    int nLength = GetTimeFormatEx(L"en-US", 0, &st, L"HH:mm:ss", szTime, sizeof(szTime)/sizeof(WCHAR));

    if (nLength > 0) {
        wprintf(L"Formatted Time: %s\n", szTime);
    } else {
        wprintf(L"Error getting time format. Error code: %lu\n", GetLastError());
    }

    return 0;
}

此示例获取当前本地时间,使用默认时间格式 "HH:mm:ss" 格式化时间,并将结果打印到控制台。你可以根据需要调整 lpFormat 和 lpLocaleName 参数以指定其他自定义日期/时间格式和语言。


转载请注明出处:http://www.zyzy.cn/article/detail/26278/Win32 API/Datetimeapi.h/GetTimeFormatEx