Sdílet prostřednictvím


DateAndTime.DateValue(String) Metoda

Definice

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

Platí pro

Viz také