DateAndTime.DateValue 方法

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

命名空間： Microsoft.VisualBasic
組件： Microsoft.VisualBasic (在 microsoft.visualbasic.dll 中)

語法

'宣告
Public Shared Function DateValue ( _
    StringDate As String _
) As DateTime
'用途
Dim StringDate As String
Dim returnValue As DateTime

returnValue = DateAndTime.DateValue(StringDate)

public static DateTime DateValue (
    string StringDate
)

public:
static DateTime DateValue (
    String^ StringDate
)

public static DateTime DateValue (
    String StringDate
)

public static function DateValue (
    StringDate : String
) : DateTime

參數

• StringDate
  必要項。String 運算式，表示從西元 1 年的一月 1 日 00:00:00 到西元 9999 年十二月 31 日 23:59:59 之間的日期 / 時間值。

傳回值

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

備註

如需詳細資訊，請參閱 Visual Basic 的主題 DateValue 函式 (Visual Basic)。

如果 StringDate 只包括有效日期分隔符號所分隔的 1 到 12 之間的數字，所以 DateValue 可根據系統指定之簡短日期格式來辨識月、日和年的順序。DateValue 會使用 System.Globalization 命名空間內 CultureInfo 類別的 CurrentCulture 屬性之目前行事曆設定。預設的 CurrentCulture 值將由 [控制台] 設定決定。您可以藉由在 System.Globalization 命名空間內設定DateTimeFormatInfo 類別的 ShortDatePattern 屬性，覆寫簡短日期格式。

DateValue 會以完整、縮寫和數字形式識別月份名稱。例如，除了可辨識 12/30/1991 和 12/30/91 以外，DateValue 也可辨識 December 30, 1991 和 Dec 30, 1991。

如果省略了 StringDate 的年部分，則 DateValue 會使用電腦系統日期的目前年份。

如果 StringDate 引數包含時間資訊，則 DateValue 不會在傳回值中包括這項資訊。但是，如果 StringDate 包括無效的時間資訊 (例如 "89:98")，則會發生 InvalidCastException 錯誤。

範例

此範例使用 DateValue 函式將字串轉換成日期。您也可以使用日期常值，將日期直接指派給 Object 或 Date 變數，例如 oldDate = #2/12/69#。

Dim oldDate As Date
oldDate = DateValue("February 12, 1969")

平台

Windows 98、 Windows 2000 SP4、 Windows CE、 Windows Millennium Edition、 Windows Mobile for Pocket PC、 Windows Mobile for Smartphone、 Windows Server 2003、 Windows XP Media Center Edition、 Windows XP Professional x64 Edition、 Windows XP SP2、 Windows XP Starter Edition

.NET Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊，請參閱系統需求一節的內容。

版本資訊

.NET Framework

支援版本：2.0、1.1、1.0

.NET Compact Framework

支援版本：2.0、1.0

請參閱

參考

DateAndTime 類別
DateAndTime 成員
Microsoft.VisualBasic 命名空間
DateTime

其他資源

DateValue 函式 (Visual Basic)
DateSerial 函式 (Visual Basic)
Day 函式 (Visual Basic)
Month 函式 (Visual Basic)
Now 屬性
TimeSerial 函式 (Visual Basic)
TimeValue 函式 (Visual Basic)
Weekday 函式 (Visual Basic)
Year 函式 (Visual Basic)
Date 資料型別 (Visual Basic)