Strings.FormatDateTime(DateTime, DateFormat) 方法

定義

命名空間:
Microsoft.VisualBasic
組件:
Microsoft.VisualBasic.dll

回傳一個字串表達式，代表日期/時間值。

public static string FormatDateTime(DateTime Expression, Microsoft.VisualBasic.DateFormat NamedFormat = Microsoft.VisualBasic.DateFormat.GeneralDate);
static member FormatDateTime : DateTime * Microsoft.VisualBasic.DateFormat -> string
Public Function FormatDateTime (Expression As DateTime, Optional NamedFormat As DateFormat = Microsoft.VisualBasic.DateFormat.GeneralDate) As String

參數

Expression
DateTime

必須的。 Date 表達式需要格式化。

NamedFormat
DateFormat

Optional. 表示所使用的日期/時間格式的數值。 若省略，則 DateFormat.GeneralDate 使用。

傳回

String

一個代表日期/時間值的字串表達式。

例外狀況

ArgumentException

NamedFormat 設定並不成立。

範例

此範例展示了該函數的 FormatDateTime 使用。

' English (US) format.
Dim testDate As DateTime = #3/12/1999#

' FormatDateTime returns "Friday, March 12, 1999".
' The time information is neutral (00:00:00) and therefore suppressed.
Dim testString As String = FormatDateTime(testDate, DateFormat.LongDate)

備註

資料型別 Date 總是包含日期和時間資訊。 為了型別轉換，Visual Basic 將 1/1/1（第 1 年 1 月 1 日）視為日期的中性值，00：00：00（午夜）則視為時間的中性值。 如果你把值格式化 Date 成日期/時間字串， FormatDateTime 結果字串中就不會包含中性值。 例如，如果你將 #1/1/0001 9：30：00# 轉換成字串，結果是「9：30：00 AM」;日期資訊會被抑制。 不過，日期資訊仍存在於原始 Date 值中，而且可以使用 之類的 DatePart函式來復原。

備註

如果你把參數當作字面值傳遞Expression，然後FormatDateTime根據你的應用程式設定來解釋它CurrentCulture。String 不過，如果你直接 Date 用字面形式，請使用格式 #mm/dd/yyyy#，因為 FormatDateTime 它總是根據 Date 英語（美國）文化來解釋字面意思。 這是必要的，因為如果應用程式是使用 Date 一種文化的文字來開發和編碼，然後在不同文化的平台上執行，這些 Date 文字可能會被錯誤解析。

這個 NamedFormat 論證有以下設定。

常數 Description
DateFormat.GeneralDate 請顯示日期和/或時間。 將約會部分顯示為短約會。 如果有時間部分，請顯示為長時間。 若有，兩個部分都會顯示。
DateFormat.LongDate 請使用電腦區域設定中指定的長日期格式顯示日期。
DateFormat.ShortDate 請使用電腦區域設定中指定的簡短日期格式顯示日期。
DateFormat.LongTime 請依照電腦區域設定中指定的時間格式顯示時間。
DateFormat.ShortTime 請使用 24 小時格式顯示時間 (hh：mm) 。

適用於

另請參閱