Поделиться через


DateAndTime.DateValue(String) Метод

Определение

Возвращает значение типа 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

Обязательный. Строковое выражение, представляющее значение даты и времени в диапазоне от 00:00:00 1 января 1 года до 23:59:59 31 декабря 9999 года.

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

Значение типа 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 использует текущий параметр календаря из CurrentCulture свойства CultureInfo класса в System.Globalization пространстве имен. Значения по умолчанию CurrentCulture определяются панель управления параметрами. Вы можете переопределить формат Короткой даты, задав ShortDatePattern свойство DateTimeFormatInfo класса в System.Globalization пространстве имен.

DateValue распознает названия месяцев в длинной, сокращенной и числовой форме. Например, помимо признания 30.12.1991 и 30.12.91, DateValue также признает 30 декабря 1991 года и 30 декабря 1991 года.

Если часть года опущена StringDate , DateValue использует текущий год из системной даты компьютера.

StringDate Если аргумент содержит сведения о времени, DateValue не включает их в возвращаемое значение. Однако при StringDate добавлении недопустимых сведений InvalidCastException о времени, таких как "89:98", возникает ошибка.

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

См. также раздел