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取決於 控制台 設定。 您可以在 命名空間中System.Globalization設定 ShortDatePattern 類別的 DateTimeFormatInfo 屬性，以覆寫 Short Date 格式。
DateValue 會以長、縮寫和數值形式辨識月份名稱。 例如，除了辨識 12/30/1991 和 12/30/91 之外， DateValue 也會辨識 1991 年 12 月 30 日和 1991 年 12 月 30 日。
如果省略 的 StringDate 年份部分， DateValue 請使用您計算機系統日期的目前年份。
StringDate如果自變數包含時間資訊，DateValue則不包含在傳回的值中。 不過，如果 StringDate 包含無效的時間資訊，例如 「89：98」，就會 InvalidCastException 發生錯誤。
