Функция DateValue (Visual Basic)
Обновлен: Ноябрь 2007
Возвращает значение типа Date, содержащее строковое представление даты с временем, установленным на полночь (00:00:00).
Public Function DateValue(ByVal StringDate As String) As DateTime
Параметры
- StringDate
Обязательный параметр. Выражение String, представляющее значение даты и времени в диапазоне от 00:00:00 1 января 1 года до 23:59:59 31 декабря 9999 года.
Исключения
Тип исключения |
Номер ошибки |
Условия |
|---|---|---|
Параметр StringDate содержит недопустимое значение времени. |
См. столбец "Номер ошибки", если выполняется обновление приложений Visual Basic версии 6.0, в которых используется неструктурированная обработка ошибок. (Номер ошибки можно сравнить со значением Свойство Number (объект Err).) Тем не менее, по возможности следует заменить эту систему управления ошибками на Обзор структурной обработки исключений в Visual Basic.
Заметки
Если StringDate включает только числа от 1 до 12, разделенные допустимыми разделителями даты, то DateValue распознает порядок следования месяца, дня и года в соответствии с кратким форматом, заданным для операционной системы. DateValue использует текущую настройку календаря из свойства CurrentCulture класса CultureInfo в пространстве имен System.Globalization. По умолчанию значения свойства CurrentCulture определяются настройками Панели управления. Можно переопределить краткий формат даты, задав соответствующим образом свойство ShortDatePattern класса DateTimeFormatInfo пространства имен System.Globalization.
DateValue распознает названия месяцев, представленных в полном, сокращенном и числовом виде. Например, помимо распознавания форматов 12/30/1991 и 12/30/91, DateValue также распознает форматы "December 30, 1991" и "Dec 30, 1991".
Если в параметре StringDate опускается часть, относящаяся к году, функция DateValue использует текущий год из системной даты компьютера.
Если аргумент StringDate содержит информацию о времени, функция DateValue не включает ее в возвращаемое значение. Тем не менее, если аргумент StringDate содержит недопустимое значение времени, например "89:98", возникает исключение InvalidCastException.
Пример
В этом примере функция DateValue используется для преобразования строки в дату. Можно также использовать литералы, чтобы непосредственно присвоить значение даты переменной типа Object или Date, например oldDate = #2/12/69#.
Dim oldDate As Date
oldDate = DateValue("February 12, 1969")
Требования
Пространство имен:Microsoft.VisualBasic
Модуль: DateAndTime
**Сборка:**Visual Basic (библиотека времени выполнения, в Microsoft.VisualBasic.dll)
См. также
Ссылки
Функция DateSerial (Visual Basic)
Функция TimeSerial (Visual Basic)
Функция TimeValue (Visual Basic)
Функция Weekday (Visual Basic)