GetDateFormatW 函数是 Windows API 中的一个函数,用于获取日期的格式化字符串。与 GetDateFormatA 和 GetDateFormatEx 不同,GetDateFormatW 是用于 Unicode 字符集的版本,接受宽字符字符串。

以下是 GetDateFormatW 函数的一般形式和一些参数的说明:
int GetDateFormatW(
  LCID             Locale,
  DWORD            dwFlags,
  const SYSTEMTIME *lpDate,
  LPCWSTR          lpFormat,
  LPWSTR           lpDateStr,
  int              cchDate
);

参数说明:

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

  •  dwFlags:指定格式化的日期标志。可以是日期格式选项的组合,例如 DATE_SHORTDATE 或 DATE_LONGDATE。

  •  lpDate:指向 SYSTEMTIME 结构的指针,包含要格式化的日期和时间。

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

  •  lpDateStr:接收格式化日期/时间字符串的缓冲区。

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


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

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

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

    WCHAR szDate[50];
    int nLength = GetDateFormatW(LOCALE_USER_DEFAULT, 0, &st, L"yyyy-MM-dd", szDate, sizeof(szDate)/sizeof(WCHAR));

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

    return 0;
}

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


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