Udostępnij za pośrednictwem


DateAndTime.DateValue(String) Metoda

Definicja

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

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

Wyjątki

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.

Dotyczy

Zobacz też