DateAndTime.DateValue(String) Метод

Определение

Возвращает значение типа Date, содержащее строковое представление даты с временем, установленным на полночь (00:00:00).Returns a Date value containing the date information represented by a string, with the time information set to midnight (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

Обязательное.Required. Строковое выражение, представляющее значение даты и времени в диапазоне от 00:00:00 1 января 1 года до 23:59:59 31 декабря 9999 года.string expression representing a date/time value from 00:00:00 on January 1 of the year 1 through 23:59:59 on December 31, 9999.

Возвращаемое значение

Значение типа Date, содержащее строковое представление даты с временем, установленным на полночь (00:00:00).A Date value containing the date information represented by a string, with the time information set to midnight (00:00:00).

Исключения

Параметр StringDate содержит недопустимое значение времени.StringDate includes invalid time information.

Примеры

В этом примере функция DateValue используется для преобразования строки в дату.This example uses the DateValue function to convert a string to a date. Можно также использовать литералы даты, чтобы непосредственно присвоить дату Object или Date переменной, например oldDate = #2/12/69#.You can also use date literals to directly assign a date to an Object or Date variable, for example, oldDate = #2/12/69#.

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

Комментарии

Если StringDate содержит только числа от 1 до 12, разделенные допустимыми разделителями дат, DateValue распознает порядок для месяца, дня и года в соответствии с кратким форматом даты, указанным для системы.If StringDate includes only numbers from 1 through 12 separated by valid date separators, DateValue recognizes the order for month, day, and year according to the Short Date format specified for your system. DateValue использует текущий параметр календаря из свойства CurrentCulture класса CultureInfo в пространстве имен System.Globalization.DateValue uses the current calendar setting from the CurrentCulture property of the CultureInfo class in the System.Globalization namespace. Значения CurrentCulture по умолчанию определяются параметрами панели управления .The default CurrentCulture values are determined by Control Panel settings. Короткий формат даты можно переопределить, задав свойство ShortDatePattern класса DateTimeFormatInfo в пространстве имен System.Globalization.You can override the Short Date format by setting the ShortDatePattern property of the DateTimeFormatInfo class in the System.Globalization namespace.

DateValue распознает названия месяцев в длинном, сокращенном и числовом формате.DateValue recognizes month names in long, abbreviated, and numeric form. Например, помимо распознавания 12/30/1991 и 12/30/91, DateValue также распознает 30 декабря 1991 и 30 декабря 1991.For example, in addition to recognizing 12/30/1991 and 12/30/91, DateValue also recognizes December 30, 1991 and Dec 30, 1991.

Если часть года StringDate опущена, DateValue использует текущий год из системной даты компьютера.If the year part of StringDate is omitted, DateValue uses the current year from your computer's system date.

Если аргумент StringDate включает сведения о времени, DateValue не включает их в возвращаемое значение.If the StringDate argument includes time information, DateValue does not include it in the returned value. Однако если StringDate содержит недопустимые сведения о времени, например "89:98", возникает ошибка InvalidCastException.However, if StringDate includes invalid time information, such as "89:98", an InvalidCastException error occurs.

Применяется к

Дополнительно