DATE, функция

Возвращает указанную дату в формате datetime.

Синтаксис

DATE(<year>, <month>, <day>)

Параметры

Элемент

Определение

year

Число, представляющее год.

Значение аргумента year может содержать от одной до четырех цифр. Аргумент year интерпретируется в соответствии с системой дат, используемой на компьютере.

Поддерживаются даты с 1 марта 1900 г.

Если ввести число с десятичными разрядами, то оно будет округлено.

Для значений больше 9999 или меньше нуля (отрицательные значения) функция возвращает ошибку #VALUE!.

Если значение year находится между 0 и 1899, оно добавляется к 1900 для получения конечного значения. См. примеры ниже.

Примечание

Для предотвращения нежелательных результатов следует по возможности использовать для аргумента year четыре цифры.Например, цифры 07, использованные в аргументе year, соответствуют значению 1907.

month

Число, обозначающее месяц, или вычисление по следующим правилам.

Если месяц является числом от 1 до 12, то он представляет месяц года. 1 соответствует январю, 2 соответствует февралю и так далее до 12, что соответствует декабрю.

При вводе целого числа, значение которого превышает 12, выполняется следующее вычисление: дата рассчитывается посредством добавления значения month к значению year. Например, если DATE имеет значение ( 2008, 18, 1), функция возвращает значение datetime, равное 1 июня 2009 года, поскольку 18 месяцев добавляются к началу 2008 года, давая в результате значение, которое равно июню 2009 года. См. примеры ниже.

При вводе целого отрицательного числа выполняется следующее вычисление: дата рассчитывается посредством вычитания значения month из значения year. Например, если DATE имеет значение ( 2008, -6, 15), функция возвращает значение datetime, равное 15 июня 2007 года, поскольку 6 месяцев вычитаются от начала 2008 года, давая в результате значение, которое равно июню 2007 года. См. примеры ниже.

day

Число, обозначающее день, или вычисление по следующим правилам.

Если day является числом от 1 до последнего дня данного месяца, то он обозначает день месяца.

При вводе целого числа, значение которого больше значения последнего дня данного месяца, выполняется следующее вычисление: дата рассчитывается посредством добавления значения day к значению month. Например, в формуле DATE( 2008, 3, 32) функция DATE возвращает значение datetime, равное 1 апреля 2008 года, поскольку 32 дня добавляются к началу марта, давая в результате значение, которое равно 1 апреля.

При вводе целого отрицательного числа выполняется следующее вычисление: дата рассчитывается посредством вычитания значения day из значения month. Например, в формуле DATE( 2008, 5, -15) функция DATE возвращает значение datetime, равное 15 апреля 2008 года, поскольку 15 дней вычитаются от начала мая 2008 года, давая в результате значение, которое равно апрелю 2008 года.

Если день содержит десятичное число, то его значение округляется до ближайшего целочисленного значения.

Возвращаемое значение

Возвращает указанную дату (datetime)).

Замечания

Функция DATE принимает целочисленные входные аргументы и вычисляет соответствующую дату. Функция DATE наиболее полезна в ситуациях, когда день, месяц и год берутся из формул. Например, базовые данные могут содержать даты в формате, который не распознается в качестве значения даты, например формат ГГГГММДД. Используя функцию DATE совместно с другими функциями, можно преобразовать такие значения даты в число, которое будет распознаваться в качестве даты.

В отличие от Microsoft Excel, где даты хранятся в виде порядковых номеров, функции даты DAX всегда возвращают тип данных datetime. Однако в случае необходимости с помощью параметров форматирования можно настроить отображение дат в виде порядковых номеров.

Эта функция DAX может возвращать другие результаты при использовании в развернутой модели в режиме DirectQuery. Дополнительные сведения о семантических отличиях в режиме DirectQuery см. по адресу http://go.microsoft.com/fwlink/?LinkId=219171.

Пример Возвращение простой даты

Описание

Следующая формула возвращает дату 8 июля 2009 г.:

Код

=DATE(2009,7,8)

Пример. Годы до 1899 г.

Описание

Если значение, введенное для аргумента year, лежит в пределах от 0 (нуля) до 1899 (включительно), то для вычисления года к этому значению добавляется 1900. Следующая формула возвращает 2 января 1908 г.: (1900+08).

Код

=DATE(08,1,2)

Пример. Годы до 1899 г.

Описание

Если значение, введенное для аргумента year, лежит в пределах от 0 (нуля) до 1899 (включительно), то для вычисления года к этому значению добавляется 1900. Следующая формула возвращает 2 января 3700 г.: (1900+1800).

Код

=DATE(1800,1,2)

Пример. Годы после 1899 г.

Описание

Если аргумент year имеет значение от 1900 до 9999 (включительно), то это значение используется в качестве года. Следующая формула возвращает 2 января 2008 г.:

Код

=DATE(2008,1,2)

Пример. Работа с месяцами

Описание

Если значение аргумента month превышает 12, то соответствующее количество месяцев добавляется к первому месяцу указанного года. Следующая формула возвращает дату 2 февраля 2009 г.:

Код

=DATE(2008,14,2)

Комментарий

Если аргумент month имеет значение меньше 1, то функция DATE вычитает соответствующее количество месяцев плюс 1 из первого месяца указанного года. Следующая формула возвращает 2 сентября 2007 г.:

=DATE(2008,-3,2)

Пример. Работа с днями

Описание

Если значение аргумента day превышает число дней в указанном месяце, то соответствующее количество дней добавляется к первому дню месяца. Следующая формула возвращает дату 4 февраля 2008 г.:

Код

=DATE(2008,1,35)

Комментарий

Если аргумент day имеет значение меньше 1, то из первого дня указанного месяца вычитается соответствующее количество дней плюс 1. Следующая формула возвращает 16 декабря 2007 г.:

=DATE(2008,1,-15)

См. также

Справочник

DAY, функция

TODAY, функция

Другие ресурсы

Функции даты и времени (DAX)