DateAndTime.DateValue(String) Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic

Zestaw:

Microsoft.VisualBasic.Core.dll

Źródło:

DateAndTime.vb

Zwraca wartość zawierającą Date informacje o dacie reprezentowane przez ciąg z informacjami o czasie ustawionym na północ (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

Wymagane. wyrażenie ciągu reprezentujące wartość daty/godziny z 00:00:00 w dniu 1 stycznia od 1 do 23:59:59 w dniu 31 grudnia 9999 r.

Zwraca

DateTime

Date Wartość zawierająca informacje o dacie reprezentowane przez ciąg z informacjami o czasie ustawionym na północ (00:00:00).

Wyjątki

InvalidCastException

StringDate zawiera nieprawidłowe informacje o czasie.

Przykłady

W tym przykładzie użyto DateValue funkcji w celu przekonwertowania ciągu na datę. Można również użyć literałów dat, aby bezpośrednio przypisać datę do zmiennej Object lub Date , na przykład oldDate = #2/12/69#.

Dim oldDate As Date
oldDate = DateValue("February 12, 1969")

Uwagi

Jeśli StringDate zawiera tylko liczby od 1 do 12 oddzielone prawidłowymi separatorami dat, DateValue rozpoznaje kolejność miesiąca, dnia i roku zgodnie z formatem daty krótkiej określonej dla systemu. DateValue używa bieżącego ustawienia kalendarza z CurrentCulture właściwości CultureInfo klasy w System.Globalization przestrzeni nazw. Wartości domyślne CurrentCulture są określane przez ustawienia Panel sterowania. Format daty krótkiej można zastąpić, ustawiając ShortDatePattern właściwość DateTimeFormatInfo klasy w System.Globalization przestrzeni nazw.

DateValue rozpoznaje nazwy miesięcy w postaci długiej, skróconej i liczbowej. Oprócz rozpoznawania 12/30/1991 i 12/30/91, DateValue rozpoznaje również 30 grudnia 1991 r. i 30 grudnia 1991 r.

Jeśli część StringDate roku zostanie pominięta, DateValue użyj bieżącego roku z daty systemu komputera.

StringDate Jeśli argument zawiera informacje o czasie, DateValue nie uwzględnia go w zwróconej wartości. Jeśli jednak StringDate zawiera nieprawidłowe informacje o czasie, takie jak "89:98", InvalidCastException wystąpi błąd.

Zobacz też

• DateSerial(Int32, Int32, Int32)
• Day(DateTime)
• Month(DateTime)
• Now
• TimeSerial(Int32, Int32, Int32)
• TimeValue(String)
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• DateTime
• Typ danych — Podsumowanie (Visual Basic)