DateAndTime.DateValue(String) 方法

  • 参考

定义

命名空间:
Microsoft.VisualBasic
程序集:
Microsoft.VisualBasic.Core.dll
程序集:
Microsoft.VisualBasic.dll
Source:
DateAndTime.vb
Source:
DateAndTime.vb
Source:
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使用命名空间中 类的 CultureInfo 属性中的System.Globalization当前日历设置CurrentCulture。 默认值CurrentCulture由控制面板设置确定。 可以通过在 命名空间中System.Globalization设置 ShortDatePattern 类的 DateTimeFormatInfo 属性来替代 Short Date 格式。

DateValue 以长、缩写和数字形式识别月份名称。 例如，除了承认 1991 年 12 月 30 日和 12/30/91 外， DateValue 还承认 1991 年 12 月 30 日和 1991 年 12 月 30 日。

如果省略 的 StringDate 年份部分， DateValue 则使用计算机系统日期中的当前年份。

StringDate如果 参数包含时间信息，DateValue则 不会将其包含在返回的值中。 但是，如果 StringDate 包含无效的时间信息，例如“89：98”，则会发生错误 InvalidCastException 。

适用于

另请参阅