DateAndTime.DateValue(String) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
回傳 Date 一個包含日期資訊的值，該資訊由字串表示，時間資訊設定為午夜（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 DateTime參數
- StringDate
- String
必須的。 字串表達式代表從第1年1月1日00：00：00到9999年12月31日23：59：59的日期/時間值。
傳回
一個 Date 包含日期資訊的值，以字串表示，時間資訊設定為午夜（00：00：00）。
例外狀況
StringDate 包含無效時間資訊。
範例
這個範例使用了 DateValue 將字串轉換成日期的函式。 你也可以使用日期字面值直接將日期指派給某個Object或Date變數，例如。 oldDate = #2/12/69#
Dim oldDate As Date
oldDate = DateValue("February 12, 1969")
備註
僅 StringDate 包含1至12的數字，並以有效日期分隔符分隔，並 DateValue 依照您系統指定的短日期格式，辨識月份、日期和年份的順序。
DateValue使用命名CurrentCulture空間中類別System.Globalization屬性CultureInfo中的當前日曆設定。 預設 CurrentCulture 值由 控制面板 設定決定。 你可以在命名空間中設定ShortDatePattern類別System.Globalization的DateTimeFormatInfo屬性來覆蓋短日期格式。
DateValue 能辨識長篇、縮寫及數字形式的月份名稱。 例如，除了承認1991年12月30日及12月30日外， DateValue 也承認1991年12月30日及1991年12月30日。
如果省略了年份 StringDate 部分，則使用 DateValue 電腦系統日期的當前年份。
若參數 StringDate 包含時間資訊， DateValue 則不包含在回傳值中。 然而，若 StringDate 包含無效時間資訊，如「89：98」，則 InvalidCastException 會發生錯誤。
