DateAndTime.DateValue(String) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Retourneert een Date waarde die de datumgegevens bevat die worden vertegenwoordigd door een tekenreeks, waarbij de tijdgegevens zijn ingesteld op middernacht (00:00:00).
public:
static DateTime DateValue(System::String ^ StringDate);public static DateTime DateValue(string StringDate);static member DateValue : string -> DateTimePublic Function DateValue (StringDate As String) As DateTimeParameters
- StringDate
- String
Required. tekenreeksexpressie die een datum/tijd-waarde van 00:00:00 weergeeft op 1 januari van het jaar 1 tot en met 23:59:59 op 31 december 9999.
Retouren
Een Date waarde met de datumgegevens die worden vertegenwoordigd door een tekenreeks, waarbij de tijdgegevens zijn ingesteld op middernacht (00:00:00).
Uitzonderingen
StringDate bevat ongeldige tijdgegevens.
Voorbeelden
In dit voorbeeld wordt de DateValue functie gebruikt om een tekenreeks te converteren naar een datum. U kunt ook letterlijke datums gebruiken om een datum rechtstreeks toe te wijzen aan een Object of Date variabele, bijvoorbeeld oldDate = #2/12/69#.
Dim oldDate As Date
oldDate = DateValue("February 12, 1969")
Opmerkingen
Als StringDate alleen getallen van 1 tot en met 12 zijn gescheiden door geldige datumscheidingstekens, DateValue herkent u de volgorde voor maand, dag en jaar volgens de notatie Korte datum die voor uw systeem is opgegeven.
DateValue gebruikt de huidige agenda-instelling van de CurrentCulture eigenschap van de CultureInfo klasse in de System.Globalization naamruimte. De standaardwaarden CurrentCulture worden bepaald door Configuratiescherm-instellingen. U kunt de notatie Korte datum overschrijven door de ShortDatePattern eigenschap van de DateTimeFormatInfo klasse in de naamruimte in te System.Globalization stellen.
DateValue herkent maandnamen in lange, afgekorte en numerieke vorm. Naast het herkennen van 12-30-1991 en 30-12-30-91, DateValue herkent u ook 30 december 1991 en 30 december 1991.
Als het jaargedeelte StringDate wordt weggelaten, DateValue gebruikt u het huidige jaar vanaf de systeemdatum van uw computer.
Als het StringDate argument tijdgegevens bevat, DateValue wordt deze niet opgenomen in de geretourneerde waarde. Als StringDate er echter ongeldige tijdgegevens zijn opgenomen, zoals '89:98', treedt er een InvalidCastException fout op.