GetTimeFormatW 函数是 Windows API 中的一个函数,用于获取时间的格式化字符串,与 GetTimeFormatA 和 GetTimeFormatEx 不同,GetTimeFormatW 是用于 Unicode 字符集的版本,接受宽字符字符串。

以下是 GetTimeFormatW 函数的一般形式和一些参数的说明:
int GetTimeFormatW(
  LCID             Locale,
  DWORD            dwFlags,
  const SYSTEMTIME *lpTime,
  LPCWSTR          lpFormat,
  LPWSTR           lpTimeStr,
  int              cchTime
);

参数说明:

  •  Locale:指定一个区域设置标识符(LCID),用于指定时间的语言和格式规则。

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

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

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

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

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


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

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

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

    WCHAR szTime[50];
    int nLength = GetTimeFormatW(LOCALE_USER_DEFAULT, 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 参数以指定其他自定义日期/时间格式。


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