Функция DateValueDateValue function

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

СинтаксисSyntax

ДАТАЗНАЧ(Date)DateValue(date)

Аргумент Date является, как правило, строковым выражением , представляющим дату с 1 января 100 до 31 декабря 9999.The required date argument is normally a string expression representing a date from January 1, 100, through December 31, 9999. Однако date также может быть выражением, представляющим дату, время или и то, и другое в этом диапазоне.However, date can also be any expression that can represent a date, a time, or both a date and time, in that range.

ПримечанияRemarks

Если Date — это строка, включающая только числа, разделенные допустимыми разделителями даты, функция DateValue распознает порядок следования месяца, дня и года в соответствии с кратким форматом даты, указанным для системы.If date is a string that includes only numbers separated by valid date separators, DateValue recognizes the order for month, day, and year according to the Short Date format that you specified for your system. DateValue также распознает однозначные даты с названиями месяцев в полной или сокращенной форме.DateValue also recognizes unambiguous dates that contain month names, either in long or abbreviated form. Например, помимо 12/30/1991 и 12/30/91 DateValue также распознает "30 декабря 1991" и "30 дек 1991".For example, in addition to recognizing 12/30/1991 and 12/30/91, DateValue also recognizes December 30, 1991 and Dec 30, 1991.

Если часть date с годом опущена, DateValue использует текущий год системной даты вашего компьютера.If the year part of date is omitted, DateValue uses the current year from your computer's system date.

Если аргумент date содержит данные о времени, DateValue не возвращает их.If the date argument includes time information, DateValue doesn't return it. Но если date содержит недопустимые данные о времени (например, "89:98"), возникает ошибка.However, if date includes invalid time information (such as "89:98"), an error occurs.

Примечание

Если в свойстве Calendar задан григорианский календарь, аргумент дата следует указывать соответствующим образом.For date, if the Calendar property setting is Gregorian, the supplied date must be Gregorian. Если используется календарь Хиджра, дата должна соответствовать ему.If the calendar is Hijri, the supplied date must be Hijri. В этом случае аргумент date — это значение типа String, представляющее дату от 1/1/100 (2 августа 718 г. грегорианского календаря) до 4/3/9666 (31 декабря 9999 г. грегорианского календаря).If the supplied date is Hijri, the argument date is a String representing a date from 1/1/100 (Gregorian Aug 2, 718) through 4/3/9666 (Gregorian Dec 31, 9999).

ПримерExample

В этом примере функция DateValue используется для преобразования строки в дату.This example uses the DateValue function to convert a string to a date. Вы также можете использовать литералы даты, чтобы напрямую назначить дату переменной Variant или Date, например MyDate = #2/12/69#.You can also use date literals to directly assign a date to a Variant or Date variable, for example, MyDate = #2/12/69#.

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


См. такжеSee also

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

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи?Have questions or feedback about Office VBA or this documentation? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.