共用方式為

Strings.FormatDateTime 方法

傳回表示日期/時間值的字串運算式。

命名空間： Microsoft.VisualBasic
組件： Microsoft.VisualBasic (在 microsoft.visualbasic.dll 中)

語法

'宣告
Public Shared Function FormatDateTime ( _
    Expression As DateTime, _
    <OptionalAttribute> Optional NamedFormat As DateFormat = DateFormat.GeneralDate _
) As String
'用途
Dim Expression As DateTime
Dim NamedFormat As DateFormat
Dim returnValue As String

returnValue = Strings.FormatDateTime(Expression, NamedFormat)

public static string FormatDateTime (
    DateTime Expression,
    [OptionalAttribute] DateFormat NamedFormat
)

public:
static String^ FormatDateTime (
    DateTime Expression, 
    [OptionalAttribute] DateFormat NamedFormat
)

public static String FormatDateTime (
    DateTime Expression, 
    /** @attribute OptionalAttribute() */ DateFormat NamedFormat
)

public static function FormatDateTime (
    Expression : DateTime, 
    NamedFormat : DateFormat
) : String

參數

  • Expression
    必要項。要格式化的 Date 運算式。
  • NamedFormat
    選擇項。數值，表示使用的日期/時間格式。如果省略，則會使用 DateFormat.GeneralDate。

傳回值

傳回表示日期/時間值的字串運算式。

備註

如需詳細資訊，請參閱 Visual Basic 的主題 FormatDateTime 函式 (Visual Basic)。

Date 資料型別一定會包含日期和時間資訊。為了要進行型別轉換，Visual Basic 會將 1/1/1 (西元 1 年的一月 1 日) 視為該日期的中性值，並將 00:00:00 (午夜) 視為該時間的中性值。如果您將 Date 值格式化成日期/時間字串，則 FormatDateTime 不會在產生的字串中包括中性值。例如，如果您將 #1/1/0001 9:30:00# 轉換為字串，結果會是 "9:30:00 AM"；日期資訊會隱藏。但是，日期資訊仍然存在於原始的 Date 值中，而且可以使用類似 DatePart 的函式來加以復原。

Note注意事項

如果您將 Expression 引數以 String 常值的形式傳遞，則 FormatDateTime 會根據應用程式的 CurrentCulture 設定來加以解譯。但是，如果以 Date 常值的形式來傳遞，則會使用格式 #mm/dd/yyyy#，因為 FormatDateTime 一定會根據英文 (美國) 文化特性來解譯 Date 常值。這是必要的處理，因為如果使用某一文化特性的 Date 常值來開發及編寫應用程式，但是在另一個有不同文化特性的平台上執行，則 Date 常值可能會剖析錯誤。

NamedFormat 引數具有下列設定。

常數

描述

DateFormat.GeneralDate

顯示日期和 (或) 時間。以簡短日期形式顯示日期部分。如果有時間部分，則以完整時間的形式顯示。如果存在的話，則兩個部分都顯示。

DateFormat.LongDate

使用電腦地區設定中指定之完整日期格式來顯示日期。

DateFormat.ShortDate

使用電腦地區設定中指定之簡短日期格式來顯示日期。

DateFormat.LongTime

使用電腦地區設定中指定之時間格式來顯示時間。

DateFormat.ShortTime

使用 24 小時制 (hh:mm) 來顯示時間。

範例

這個範例示範 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)

平台

Windows 98、 Windows 2000 SP4、 Windows CE、 Windows Millennium Edition、 Windows Mobile for Pocket PC、 Windows Mobile for Smartphone、 Windows Server 2003、 Windows XP Media Center Edition、 Windows XP Professional x64 Edition、 Windows XP SP2、 Windows XP Starter Edition

.NET Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊，請參閱系統需求一節的內容。

版本資訊

.NET Framework

支援版本：2.0、1.1、1.0

.NET Compact Framework

支援版本：2.0、1.0

請參閱

參考

Strings 類別
Strings 成員
Microsoft.VisualBasic 命名空間
ArgumentException

其他資源

FormatDateTime 函式 (Visual Basic)
FormatCurrency 函式 (Visual Basic)
FormatNumber 函式 (Visual Basic)
FormatPercent 函式 (Visual Basic)
DatePart 函式 (Visual Basic)
字串操作摘要

  • Last updated on