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ě.