Функция DateValue

Применяется к
Access для Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Возвращает значение типа Variant (Date).

Синтаксис

DateValue(date)

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

Замечания

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

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

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

Примечание

Если параметрсвойства Calendar имеет значение григорианский, указанная дата должна быть григорианской. Если используется календарь Хиджра, дата должна соответствовать ему. Если указанная дата — Хиджри, аргумент дата представляет собой строку, представляющую дату от 01.01.100 (григорианское августа 2, 718) по 03.04.9666 (григорианская декабря 31, 9999 г.).

Примеры запросов

Выражение Результаты
SELECT DateValue([DateTime]) AS Expr1 FROM ProductSales; Возвращает значения даты поля "DateTime" в формате "Краткая дата" без сведений о времени.
SELECT DateValue([DateTime]) AS NewDate, Count(ProductSales.DateTime) AS CountOfDateTime FROM ProductSales GROUP BY DateValue([DateTime]); Возвращает значения даты поля "DateTime" в формате "Краткая дата" без сведений о времени.

Пример VBA

Примечание

В примерах ниже показано, как использовать эту функцию в модуле Visual Basic для приложений (VBA). Чтобы получить дополнительные сведения о работе с VBA, выберите Справочник разработчика в раскрывающемся списке рядом с полем Поиск и введите одно или несколько слов в поле поиска.

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

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

Выбор правильной функции даты