Strings.FormatDateTime(DateTime, DateFormat) Methode

  • Referenz

Definition

Namespace:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.Core.dll
Assembly:
Microsoft.VisualBasic.dll
Quelle:
Strings.vb
Quelle:
Strings.vb
Quelle:
Strings.vb

Gibt einen Zeichenfolgenausdruck für einen Datums- und Uhrzeitwert zurück.

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

Erforderlich. Der zu formatierende Date-Ausdruck.

NamedFormat
DateFormat

Dies ist optional. Numerischer Wert, der das verwendete Datum-/Zeitformat angibt. Wird der Wert nicht angegeben, so wird DateFormat.GeneralDate verwendet.

Gibt zurück

String

Ein Zeichenfolgenausdruck, der einen Datums-/Zeitwert darstellt.

Ausnahmen

ArgumentException

Die Einstellung NamedFormat ist nicht gü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 Date Datentyp enthält immer Datums- und Uhrzeitinformationen. Für Zwecke der Typkonvertierung betrachtet Visual Basic 1/1 (1. Januar des Jahres 1) als neutralen Wert für das Datum und 00:00:00:00 (Mitternacht) als neutralen Wert für die Zeit. Wenn Sie einen Date Wert als Datums-/Uhrzeitzeichenfolge formatieren, FormatDateTime enthält die resultierende Zeichenfolge keine neutralen Werte. Wenn Sie beispielsweise #1/1/0001 9:30:00# in eine Zeichenfolge konvertieren, lautet das Ergebnis "9:30:00 AM"; Die Datumsinformationen werden unterdrückt. Sie sind allerdings weiterhin im ursprünglichen Date-Wert vorhanden und können mit Funktionen wie DatePart wiederhergestellt werden.

Hinweis

Wenn Sie das Expression Argument als String Literal übergeben, FormatDateTime interpretiert es entsprechend der CurrentCulture Einstellung Ihrer Anwendung. Wenn Sie es jedoch als Date Literal übergeben, verwenden Sie das Format #mm/tt/JJJJ#, da FormatDateTime ein Date Literal immer entsprechend der englischen (US)-Kultur interpretiert wird. Dies ist erforderlich, denn wenn eine Anwendung mithilfe von Date Literalen aus einer Kultur entwickelt und codiert wird, dann aber auf einer Plattform mit einer anderen Kultur ausgeführt wird, könnten die Date Literale falsch analysiert werden.

Das NamedFormat Argument verfügt über die folgenden Einstellungen.

Konstante BESCHREIBUNG
DateFormat.GeneralDate Zeigen Sie ein Datum und/oder eine Uhrzeit an. Zeigen Sie ein Datumsteil als kurzes Datum an. Wenn ein Zeitteil vorhanden ist, zeigen Sie es als lange Zeit an. Falls vorhanden, werden beide Teile angezeigt.
DateFormat.LongDate Zeigen Sie ein Datum mit dem langen Datumsformat an, das in den regionalen Einstellungen Ihres Computers angegeben ist.
DateFormat.ShortDate Zeigen Sie ein Datum mit dem kurzen Datumsformat an, das in den regionalen Einstellungen Ihres Computers angegeben ist.
DateFormat.LongTime Zeigen Sie eine Zeit mit dem zeitformat an, das in den regionalen Einstellungen Ihres Computers angegeben ist.
DateFormat.ShortTime Zeigen Sie eine Zeit im 24-Stunden-Format (hh:mm) an.

Gilt für:

Weitere Informationen