DateAndTime.DateValue(String) Метод

Определение

Пространство имен:

Microsoft.VisualBasic

Сборка:

Microsoft.VisualBasic.Core.dll

Исходный код:

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

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

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

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 использует текущий параметр календаря из 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", возникает ошибка.

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

• DateSerial(Int32, Int32, Int32)
• Day(DateTime)
• Month(DateTime)
• Now
• TimeSerial(Int32, Int32, Int32)
• TimeValue(String)
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• DateTime
• Сводка типов данных (Visual Basic)