Die Funktion `FormatDateTime` in VBA (Visual Basic for Applications) wird verwendet, um Datums- und Uhrzeitwerte in ein lesbares Format zu konvertieren. Diese Funktion ist nützlich, um Datums- und Uhrzeitdarstellungen zu steuern, die den regionalen Einstellungen des Systems entsprechen oder festgelegte Formatierungen verwenden. Die Syntax und Verwendung dieser Funktion ist relativ einfach. Hier ist eine allgemeine Beschreibung und Beispiele zur Verwendung:
Syntax der FormatDateTime-Funktion
FormatDateTime(DateValue, [NamedFormat])
- DateValue: Erforderlich. Ein Ausdruck, der ein Datum oder eine Uhrzeit darstellt.
- NamedFormat: Optional. Eine numerische Konstante, die das gewünschte Datums-/Uhrzeitformat angibt. Diese Konstante kann folgende Werte annehmen:
- `vbGeneralDate` (0): Zeigt Datum und/oder Uhrzeit an. Datumsteile werden als Kurzdatum angezeigt. Zeitteile werden als Langzeit angezeigt. Wenn es keinen Zeitanteil gibt, wird nur das Datum angezeigt, und umgekehrt.
- `vbLongDate` (1): Zeigt das Datum im Langformat gemäß den regionalen Einstellungen an.
- `vbShortDate` (2): Zeigt das Datum im Kurzformat gemäß den regionalen Einstellungen an.
- `vbLongTime` (3): Zeigt die Uhrzeit im Langformat gemäß den regionalen Einstellungen an.
- `vbShortTime` (4): Zeigt die Uhrzeit im 24-Stunden-Format (hh:mm) an.
Beispiele
Hier sind einige Beispiele, wie Sie `FormatDateTime` verwenden können:
Sub FormatDateTimeExample()
Dim dt As Date
dt = Now ' Aktuelles Datum und Uhrzeit
' Beispiel 1: Allgemeines Datum
MsgBox FormatDateTime(dt, vbGeneralDate)
' Beispiel 2: Langdatum
MsgBox FormatDateTime(dt, vbLongDate)
' Beispiel 3: Kurzdatum
MsgBox FormatDateTime(dt, vbShortDate)
' Beispiel 4: Langzeit
MsgBox FormatDateTime(dt, vbLongTime)
' Beispiel 5: Kurzzeit
MsgBox FormatDateTime(dt, vbShortTime)
End Sub
Hinweise
- Wenn das optionale `NamedFormat`-Argument weggelassen wird, wird standardmäßig `vbGeneralDate` verwendet.
- Diese Funktion berücksichtigt die Datum- und Uhrzeiteinstellungen des Betriebssystems, weshalb die angezeigten Formate variieren können, je nachdem, welche regionalen Einstellungen auf dem Computer festgelegt sind.
Mit `FormatDateTime` können Sie Datum und Uhrzeit in einem lesbaren und benutzerfreundlichen Format in Ihren VBA-Anwendungen darstellen, was die Interpretierbarkeit für Endbenutzer verbessert.