Strings.FormatDateTime(DateTime, DateFormat) Methode

Definitie

Naamruimte:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

Retourneert een tekenreeksexpressie die een datum/tijd-waarde vertegenwoordigt.

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

Parameters

Expression
DateTime

Required. Date expressie die moet worden opgemaakt.

NamedFormat
DateFormat

Optional. Een numerieke waarde die aangeeft welke datum-/tijdnotatie moet worden gebruikt. Als u dit weglaat, DateFormat.GeneralDate wordt deze gebruikt.

Retouren

String

Een tekenreeksexpressie die een datum/tijd-waarde vertegenwoordigt.

Uitzonderingen

ArgumentException

NamedFormat de instelling is ongeldig.

Voorbeelden

In dit voorbeeld ziet u hoe de FormatDateTime functie wordt gebruikt.

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

Opmerkingen

Het Date gegevenstype bevat altijd zowel datum- als tijdgegevens. Voor de conversie van het type is Visual Basic van mening dat 1-1-1 (1 januari van het jaar 1) een neutrale waarde voor de datum is en 00:00:00 (middernacht) een neutrale waarde voor de tijd is. Als u een Date waarde opmaken als een datum/tijd-tekenreeks, FormatDateTime bevat deze geen neutrale waarden in de resulterende tekenreeks. Als u bijvoorbeeld #1-1-0001 9:30:00# converteert naar een tekenreeks, is het resultaat '9:30:00 uur'; de datumgegevens worden onderdrukt. De datumgegevens zijn echter nog steeds aanwezig in de oorspronkelijke Date waarde en kunnen worden hersteld met functies zoals DatePart.

Note

Als u het Expression argument als een String letterlijke waarde doorgeeft, FormatDateTime interpreteert u het op basis van de CurrentCulture instelling van uw toepassing. Als u deze echter doorgeeft als een Date letterlijke notatie, gebruikt u de notatie #mm/dd/jjjj#, omdat FormatDateTime een letterlijke tekst altijd wordt geïnterpreteerd Date volgens de Engelse cultuur (VS). Dit is nodig omdat, als een toepassing wordt ontwikkeld en gecodeerd met behulp van Date letterlijke gegevens uit één cultuur, maar vervolgens wordt uitgevoerd op een platform met een andere cultuur, de Date letterlijke gegevens onjuist kunnen worden geparseerd.

Het NamedFormat argument heeft de volgende instellingen.

Constante Beschrijving
DateFormat.GeneralDate Een datum en/of tijd weergeven. Een datumonderdeel weergeven als een korte datum. Als er een tijdgedeelte is, wordt dit weergegeven als een lange tijd. Indien aanwezig, worden beide onderdelen weergegeven.
DateFormat.LongDate Een datum weergeven met de lange datumnotatie die is opgegeven in de landinstellingen van uw computer.
DateFormat.ShortDate Een datum weergeven met de korte datumnotatie die is opgegeven in de landinstellingen van uw computer.
DateFormat.LongTime Een tijd weergeven met de tijdnotatie die is opgegeven in de landinstellingen van uw computer.
DateFormat.ShortTime Een tijd weergeven met de 24-uursnotatie (uu: mm).

Van toepassing op

Zie ook