GetDateFormat

GetDateFormat是一個Windows API函式。它用來針對指定的“當地”格式，對一個系統日期進行格式化。

基本介紹

• 中文名：GetDateFormat
• 屬於：Windows API
• 用途：對一個系統日期進行格式化
• 性質：函式

語法

intGetDateFormat(LCIDLocale,DWORDdwFlags,constSYSTEMTIME*lpDate,LPCTSTRlpFormat,LPTSTRlpDateStr,intcchDate);

VB聲明

DeclareFunctionGetDateFormatLib"kernel32"Alias"GetDateFormatA"(ByValLocaleAsLong,ByValdwFlagsAsLong,lpDateAsSYSTEMTIME,ByVallpFormatAsString,ByVallpDateStrAsString,ByValcchDateAsLong)AsLong

參數

Locale

Long，用於決定格式的地方ID。lpFormat參數中指定的任何信息（倘若不是NULL）都優先於特定於地方的信息

dwFlags

Long，如指定了lpFormat，那么該參數應該為零。否則，可設為LOCALE_NOUSEROVERRIDE，強制使用系統地方參數——即使它們已由用戶取代。用DATE_SHORTDATE或DATE_LONGDATE選擇不同的日期格式。

lpDate

SYSTEMTIME，包含了一個系統日期的結構。

lpFormat

String，可設為NULL，使用特定於不同地方的值（用vbNullString傳遞一個NULL）。否則包含一個日期格式字串。對d,dd,ddd,dddd,m,mm,mmm,mmmm,y,yy,yyyy這樣的代碼，它們的用法與在vb格式命令中的用法是相同的。注意用gg指定一個“紀元”

lpDateStr

String，指定一個緩衝區，用於容納格式化過後的字串。注意事先對字串進行初始化。

cchDate

Long，lpDateStr緩衝區的長度。如為零，表示函式會返回需要緩衝區的大小。

返回值

Long，格式化過後的字串的長度。零表示出錯，會將GetLastError設定為下述值之一：ERROR_INSUFFICIENT_BUFFER，ERROR_INVALID_FLAGS，ERROR_INVALID_PARAMETER

需求

Windows NT/2000/XP	包含於Windows NT 3.5以及更高的版本。
Windows 95/98/Me	包含於Windows 95以及更高的版本。
頭檔案	在Winnls.h中聲明，包含於Windows.h。
庫檔案	Kernel32.lib。
Unicode	在Windows NT/2000/XP中以Unicode和ANSI版本實現。