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 января по 23:59:59 31 декабря 9999 года.
Возвращаемое значение
Date Значение, содержащее сведения о дате, представленные строкой, со сведениями о времени, заданными в полночь (00:00:00).
Исключения
StringDate содержит недопустимые сведения о времени.
Примеры
В этом примере функция используется DateValue для преобразования строки в дату. Можно также использовать литералы дат для непосредственного назначения даты или переменнойObject, напримерoldDate = #2/12/69#.Date
Dim oldDate As Date
oldDate = DateValue("February 12, 1969")
Комментарии
Если StringDate включает только числа от 1 до 12, разделенные допустимыми разделителями дат, DateValue распознает порядок в течение месяца, дня и года в соответствии с форматом короткой даты, указанным для вашей системы.
DateValueиспользует текущий параметр календаря CultureInfo из CurrentCulture свойства класса в System.Globalization пространстве имен. Значения по умолчанию CurrentCulture определяются параметрами панели управления . Можно переопределить формат Short Date, задав ShortDatePattern свойство DateTimeFormatInfo класса в System.Globalization пространстве имен.
DateValue распознает имена месяцев в длинной, сокращенной и числовой форме. Например, помимо признания 12.30.1991 и 12.30.91, DateValue также признается 30 декабря 1991 г. и 30 декабря 1991 г.
Если часть StringDate года опущена, DateValue использует текущий год из системной даты компьютера.
StringDate Если аргумент содержит сведения о времени, DateValue не включает его в возвращаемое значение. Однако при StringDate наличии недопустимых сведений о времени, таких как "89:98", InvalidCastException возникает ошибка.
