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 informacemi o čase nastaveném 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é. řetězcový výraz představující hodnotu data a času od 00:00:00 dne 1. ledna roku 1 do 23:59:59 31. prosince 9999.
Návraty
Hodnota Date obsahující informace o datu reprezentované řetězcem s informacemi o čase nastaveném na půlnoc (00:00:00).
Výjimky
StringDate obsahuje neplatné informace o čase.
Příklady
Tento příklad používá funkci k převodu DateValue řetězce na datum. Literály kalendářních dat můžete také použít k přímému přiřazení data k Object proměnné nebo Date proměnné, oldDate = #2/12/69#například .
Dim oldDate As Date
oldDate = DateValue("February 12, 1969")
Poznámky
Pokud StringDate obsahuje pouze čísla od 1 do 12 oddělených 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é datum zadaného pro váš systém.
DateValue používá 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ích panelů . Formát Krátké datum 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ém, zkrácené a číselné podobě. Kromě rozpoznávání 12. 30. 1991 a 30. prosince 1991 DateValue a 30. prosince 1991 také rozpozná 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 ale obsahuje neplatné informace o čase, například 89:98, dojde k InvalidCastException chybě.