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使用命名空间中 类的 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 。
