DateAndTime.DateValue(String) 方法

定義

傳回 Date 值,包含由字串表示的日期資訊,且其時間資訊設定為午夜 (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

參數

StringDate
String

必要。 字串運算式,表示從西元 1 年的 1 月 1 日 00:00:00 到西元 9999 年 12 月 31 日 23:59:59 之間的日期/時間值。

傳回

Date 值,包含由字串表示的日期資訊,且其時間資訊設定為午夜 (00:00:00)。

例外狀況

StringDate 包含無效時間資訊。

範例

此範例會使用 函 DateValue 式將字串轉換成日期。 您也可以使用日期常值,直接將日期指派給 ObjectDate 變數,例如 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 發生錯誤。

適用於

另請參閱