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
必填。 字符串表达式，表示 9999 年 1 月 1 日的 00：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来替代短日期格式。
DateValue 以长、缩写和数字形式识别月份名称。 例如，除了识别 12/30/1991 和 12/30/91 之外， DateValue 还承认 1991 年 12 月 30 日和 1991 年 12 月 30 日。
如果省略该年份部分 StringDate ， DateValue 请使用计算机系统日期中的当前年份。
StringDate如果参数包含时间信息，DateValue则不将其包含在返回的值中。 但是，如果 StringDate 包含无效的时间信息，例如“89：98”， InvalidCastException 则会发生错误。
