GetTimeFormat

GetTimeFormat

VB聲明

Declare Function GetTimeFormat Lib "kernel32" Alias "GetTimeFormatA" (ByVal Locale As Long, ByVal dwFlags As Long, lpTime As SYSTEMTIME, ByVal lpFormat As String, ByVal lpTimeStr As String, ByVal cchTime As Long) As Long

說明

針對當(dāng)前指定的“地方”，按特定的格式格式化一個系統(tǒng)時間

返回值

Long，格式化過后的字串的長度。零表示出錯。會將GetLastError設(shè)置為下述值之一：ERROR_INSUFFICIENT_BUFFER，ERROR_INVALID_FLAGS，ERROR_INVALID_PARAMETER

參數(shù)表

參數(shù)

類型及說明

Locale

Long，決定了具體格式的地方ID。lpFormat參數(shù)中指定的任何信息（倘若不是NULL）都要優(yōu)先于各地方不同的特別信息

dwFlags

Long，如指定了lpFormat，那么該參數(shù)應(yīng)該為零。否則，可設(shè)為LOCALE_NOUSEROVERRIDE，表示強(qiáng)制使用系統(tǒng)地方參數(shù)——即使它們已由用戶更改。用DATE_SHORTDATE或DATE_LONGDATE選擇不同的日期格式

lpTime

SYSTEMTIME，用于包容系統(tǒng)時間的一個結(jié)構(gòu)

lpFormat

String，可設(shè)為NULL，使用特定于不同地方的值（用vbNullString傳遞一個NULL）。否則包含一個時間格式字串。對h,hh,hhh,hhhh,m,mm,s,ss這樣的代碼來說，它們的用法與在vb格式命令中的用法是相同的。t和tt用于指定一個時間段標(biāo)志（A或AM，P或PM）

lpTimeStr

String，指定一個緩沖區(qū)，用于容納格式化過后的字串。注意事先對字串的長度進(jìn)行正確的預(yù)初始化

cchTime

Long，lpTimeStr緩沖區(qū)的長度。如為零，表示函數(shù)會返回需要緩沖區(qū)的大小

注解

對于dwFlags參數(shù)的解釋可能翻譯有錯誤。原文為：

If lpFormat is specified, this should be zero. Otherwise, may be set to LOCALE_NOUSEROVERRIDE to force the system locale parameters to be used even if they have been overridden by the user. Use the self-explanatory constants TIME_NOMINUITESORSECONDS, TIME_NOSECONDS, or TIME_FORCE24HOURFORMAT to choose between date formats. Constant TIME_NOMARKER removes the AM or PM marker.

Top