DateAndTime.DateValue(String) Metoda

Definice

Obor názvů:

Microsoft.VisualBasic

Sestavení:

Microsoft.VisualBasic.Core.dll

Zdroj:

DateAndTime.vb

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

DateTime

Hodnota Date obsahující informace o datu reprezentované řetězcem s časovými informacemi nastavenými na půlnoc (00:00:00).

Výjimky

InvalidCastException

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

Viz také

• DateSerial(Int32, Int32, Int32)
• Day(DateTime)
• Month(DateTime)
• Now
• TimeSerial(Int32, Int32, Int32)
• TimeValue(String)
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• DateTime
• Souhrn datových typů (Visual Basic)