DateAndTime.DateValue(String) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Date
Vrátí hodnotu obsahující informace o datu reprezentované řetězcem s časovými informacemi nastavenými na půlnoc (00:00:00).
public:
static DateTime DateValue(System::String ^ StringDate);
public static DateTime DateValue (string StringDate);
static member DateValue : string -> DateTime
Public Function DateValue (StringDate As String) As DateTime
Parametry
- StringDate
- String
Povinná hodnota. řetězcový výraz představující hodnotu data a času od 00:00:00 1. ledna roku 1 do 23:59:59 k 31. prosinci 9999.
Návraty
Hodnota Date
obsahující informace o datu reprezentované řetězcem s časovými informacemi nastavenými na půlnoc (00:00:00).
Výjimky
StringDate
obsahuje neplatné informace o čase.
Příklady
Tento příklad používá DateValue
funkci k převodu řetězce na datum. K přímému přiřazení data Object
k proměnné nebo Date
můžete použít také literály data, například oldDate = #2/12/69#
.
Dim oldDate As Date
oldDate = DateValue("February 12, 1969")
Poznámky
Pokud StringDate
obsahuje pouze čísla od 1 do 12 oddělená platnými oddělovači kalendářních dat, DateValue
rozpozná pořadí pro měsíc, den a rok podle formátu krátkého data zadaného pro váš systém. DateValue
použije aktuální nastavení kalendáře z CurrentCulture vlastnosti CultureInfo třídy v System.Globalization oboru názvů. Výchozí CurrentCulture hodnoty jsou určeny nastavením Ovládací panely. Formát krátkého data můžete přepsat nastavením ShortDatePattern vlastnosti DateTimeFormatInfo třídy v System.Globalization oboru názvů.
DateValue
rozpoznává názvy měsíců v dlouhé, zkrácené a číselné podobě. Například kromě rozpoznávání 30. 12. 1991 a 30. 12. 991 DateValue
rozpozná také 30. prosince 1991 a 30. prosince 1991.
Pokud je část StringDate
roku vynechána, DateValue
použije aktuální rok ze systémového data počítače.
StringDate
Pokud argument obsahuje informace o čase, DateValue
nezahrne je do vrácené hodnoty. Pokud StringDate
však obsahuje neplatné informace o čase, například "89:98", InvalidCastException dojde k chybě.