DateAndTime.DateValue(String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает значение типа 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
Обязательный. Строковое выражение, представляющее значение даты и времени в диапазоне от 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", возникает ошибка.
