Strings.FormatDateTime(DateTime, DateFormat) Methode

Definition

Namespace:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

Gibt einen Zeichenfolgenausdruck zurück, der einen Datums-/Uhrzeitwert darstellt.

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

Parameter

Expression
DateTime

Required. Date zu formatierende Ausdruck.

NamedFormat
DateFormat

Dies ist optional. Ein numerischer Wert, der das zu verwendende Datum/Uhrzeit-Format angibt. Wenn nicht angegeben, wird DateFormat.GeneralDate verwendet.

Gibt zurück

String

Ein Zeichenfolgenausdruck, der einen Datums-/Uhrzeitwert darstellt.

Ausnahmen

ArgumentException

NamedFormat die Einstellung ist ungültig.

Beispiele

In diesem Beispiel wird die Verwendung der FormatDateTime Funktion veranschaulicht.

' 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)

Hinweise

Der Datentyp enthält immer Sowohl Datums Date - als auch Uhrzeitinformationen. Bei der Typumwandlung betrachtet Visual Basic den Wert 1/1/1 (1. Januar des Jahres 1) als neutralen Wert für das Datum und 00:00:00 (Mitternacht) als neutralen Wert für die Zeit. Wenn Sie einen Date Wert als Datums-/Uhrzeitzeichenfolge formatieren, FormatDateTime sind keine neutralen Werte in der resultierenden Zeichenfolge enthalten. Wenn Sie z. B. #1/1/0001 9:30:00# in eine Zeichenfolge konvertieren, lautet das Ergebnis "9:30:00"; Die Datumsinformationen werden unterdrückt. Die Datumsinformationen sind jedoch weiterhin im ursprünglichen Date Wert vorhanden und können mit Funktionen wie z DatePart. B. wiederhergestellt werden.

Note

Wenn Sie das Expression Argument als String Literal übergeben, FormatDateTime interpretiert es gemäß der CurrentCulture Einstellung Ihrer Anwendung. Wenn Sie es jedoch als Date Literal übergeben, verwenden Sie das Format #mm/dd/yyyy#, da FormatDateTime immer ein Date Literal gemäß der englischen Kultur (USA) interpretiert wird. Dies ist erforderlich, da, wenn eine Anwendung mit Date Literalen aus einer Kultur entwickelt und codiert wird, aber dann auf einer Plattform mit einer anderen Kultur ausgeführt wird, die Date Literale falsch analysiert werden können.

Das NamedFormat Argument weist die folgenden Einstellungen auf.

Konstante Description
DateFormat.GeneralDate Zeigt ein Datum und/oder eine Uhrzeit an. Zeigt einen Datumsteil als kurzes Datum an. Wenn ein Uhrzeitteil vorhanden ist, wird die Uhrzeit als lange Uhrzeit angezeigt. Wenn vorhanden, werden beide Teile angezeigt.
DateFormat.LongDate Zeigt ein Datum mithilfe des langen Datumsformats an, das in den Ländereinstellungen des Computers angegeben ist.
DateFormat.ShortDate Zeigt ein Datum mithilfe des kurzen Datumsformats an, das in den Ländereinstellungen des Computers angegeben ist.
DateFormat.LongTime Zeigt eine Uhrzeit mithilfe des Uhrzeitformats an, das in den Ländereinstellungen des Computers angegeben ist.
DateFormat.ShortTime Zeigt eine Uhrzeit im 24-Stunden-Format (hh:mm) an.

Gilt für:

Weitere Informationen