DateAndTime.DateValue(String) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 -> DateTimePublic Function DateValue (StringDate As String) As DateTimeParametry
- 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.
