Sdílet prostřednictvím


DateAndTime.DateValue(String) Metoda

Definice

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

Platí pro

Viz také