DateAndTime.DateValue(String) 方法

定義

命名空間:

Microsoft.VisualBasic

組件:

Microsoft.VisualBasic.Core.dll

來源:

DateAndTime.vb

傳回 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 之間的日期/時間值。

傳回

DateTime

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

例外狀況

InvalidCastException

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 發生錯誤。

另請參閱

• DateSerial(Int32, Int32, Int32)
• Day(DateTime)
• Month(DateTime)
• Now
• TimeSerial(Int32, Int32, Int32)
• TimeValue(String)
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• DateTime
• 資料類型摘要 (Visual Basic)