Функция DateValue

Возвращает Variant (Date).

Синтаксис

DateValue(date)

Обязательный аргументdate обычно представляет собой строковое выражение, представляющее дату с 1 января 100 г. по 31 декабря 9999 г. Однако date также может быть выражением, представляющим дату, время или и то, и другое в этом диапазоне.

Замечания

Если date — это строка, которая содержит только числа, разделенные допустимыми разделителями даты, DateValue распознает порядок для месяца, дня и года в соответствии с форматом коротких дат, заданным для вашей системы. DateValue также распознает однозначные даты с названиями месяцев в полной или сокращенной форме. Например, помимо 12/30/1991 и 12/30/91 DateValue также распознает "30 декабря 1991" и "30 дек 1991".

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

Если аргумент date содержит данные о времени, DateValue не возвращает их. Но если date содержит недопустимые данные о времени (например, "89:98"), возникает ошибка.

Примечание.

Если в свойстве Calendar задан григорианский календарь, аргумент дата следует указывать соответствующим образом. Если используется календарь Хиджра, дата должна соответствовать ему. В этом случае аргумент date — это значение типа String, представляющее дату от 1/1/100 (2 августа 718 г. грегорианского календаря) до 4/3/9666 (31 декабря 9999 г. грегорианского календаря).

Пример

В этом примере функция DateValue используется для преобразования строки в дату. Вы также можете использовать литералы даты, чтобы напрямую назначить дату переменной Variant или Date, например MyDate = #2/12/69#.

Dim MyDate
MyDate = DateValue("February 12, 1969")    ' Return a date.

См. также

• Функции (Visual Basic для приложений)

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.