DATE
применяется:вычисляемый столбец
вычисляемой таблицы
измерение
визуального вычисления
Возвращает указанную дату в формате datetime
.
Синтаксис
DATE(<year>, <month>, <day>)
Параметры
Срок | Определение |
---|---|
year |
Число, представляющее год. Значение аргумента year может содержать одну до четырех цифр. Аргумент year интерпретируется в соответствии с системой дат, используемой компьютером.Поддерживаются даты, начиная с 1 марта 1900 г. Если ввести число с десятичным числом, число округляется. Для значений, превышающих 9999 или меньше нуля (отрицательные значения), функция возвращает ошибку #VALUE! .Если значение year составляет от 0 до 1899, значение добавляется к 1900, чтобы получить окончательное значение. См. приведенные ниже примеры.
Примечание. следует использовать четыре цифры для аргумента year всякий раз, чтобы предотвратить нежелательные результаты. Например, при использовании 07 возвращается значение 1907 в качестве значения года. |
month |
Число, представляющее месяц или вычисление в соответствии со следующими правилами: Отрицательные целые числа не поддерживаются. Допустимые значения : 1–12. Если month число от 1 до 12, то оно представляет месяц года. 1 представляет 2 января и т. д. до 12 декабря.Если ввести целое число, превышающее 12, происходит следующее вычисление: дата вычисляется путем добавления значения month в year . Например, если у вас есть DATE(2008, 18, 1), функция возвращает значение даты и времени, эквивалентное 1 июня 2009 года, так как 18 месяцев добавляются в начало 2008 года, что дает значение 2009 года. См. приведенные ниже примеры. |
day |
Число, представляющее день или вычисление в соответствии со следующими правилами: Отрицательные целые числа не поддерживаются. Допустимые значения : 1–31. Если day является числом от 1 до последнего дня данного месяца, он представляет день месяца.Если ввести целое число, превышающее последний день данного месяца, происходит следующее вычисление: дата вычисляется путем добавления значения day в month . Например, в формуле DATE( 2008, 3, 32) функция DATE возвращает значение datetime , эквивалентное 1 апреля 2008 года, так как 32 дня добавляются в начало марта, что дает значение 1 апреля.Если day содержит десятичную часть, округляется до ближайшего целочисленного значения. |
Возвращаемое значение
Возвращает указанную дату (datetime
).
Замечания
Функция DATE принимает целые числа, входные в качестве аргументов, и создает соответствующую дату. Функция DATE наиболее полезна в ситуациях, когда год, месяц и день предоставляются формулами. Например, базовые данные могут содержать даты в формате, который не распознается как дата, например YYYYMMDDD. Функцию DATE можно использовать вместе с другими функциями для преобразования дат в число, которое можно распознать как дату.
В отличие от Microsoft Excel, в котором хранятся даты в виде серийного номера, функции даты DAX всегда возвращают тип данных
datetime
. Однако при необходимости можно использовать форматирование для отображения дат в качестве серийных номеров.Дату и дату также можно указать в виде литерала в формате
dt"YYYY-MM-DD"
,dt"YYYY-MM-DDThh:mm:ss"
илиdt"YYYY-MM-DD hh:mm:ss"
. При указании в качестве литерала использование функции DATE в выражении не требуется. Дополнительные сведения см. в DAX синтаксисе | Дата и время.Эта функция не поддерживается для использования в режиме DirectQuery при использовании в вычисляемых столбцах или правилах безопасности на уровне строк (RLS).
Примеры
Простая дата
Следующая формула возвращает дату 8 июля 2009 г.
= DATE(2009,7,8)
Годы до 1899
Если значение, введенное для аргумента year
, составляет от 0 до 1899 (включительно), это значение добавляется в 1900, чтобы вычислить год. Следующая формула возвращается 2 января 1908 г. (1900+08).
= DATE(08,1,2)
Годы после 1899
Если year
составляет от 1900 до 9999 (включительно), это значение используется в качестве года. Следующая формула возвращается 2 января 2008 г.
= DATE(2008,1,2)
Месяцы
Если month
больше 12, month
добавляет это количество месяцев к первому месяцу в указанном году. Следующая формула возвращает дату 2 февраля 2009 г.
= DATE(2008,14,2)
Дни недели
Если day
больше числа дней в указанном месяце, day
добавляет это количество дней в первый день месяца. Следующая формула возвращает дату 4 февраля 2008 г.
= DATE(2008,1,35)
Связанное содержимое
функции даты и времениDAY функцииTODAY