Функция DATE (DAX)

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

Синтаксис

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

Параметры

Элемент

Определение

year

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

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

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

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

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

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

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

month

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

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

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

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

day

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

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

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

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

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

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

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

Замечания

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

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

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

Описание

Следующая формула возвращает дату 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)

См. также

Справочник

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