DATE

  • Статья

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

Синтаксис

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

Параметры

Термин Определение
year Число, представляющее год.

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

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

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

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

Если значение года составляет от 0 до 1899, значение добавляется к 1900, чтобы получить окончательное значение. См. следующие примеры. Примечание. При возможности предотвратить нежелательные результаты следует использовать четыре цифры для аргумента года . Например, при использовании 07 возвращается значение 1907 в качестве значения года.
Месяц Число, представляющее месяц или вычисление в соответствии со следующими правилами:

Отрицательные целые числа не поддерживаются. Допустимые значения : 1–12.

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

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

Отрицательные целые числа не поддерживаются. Допустимые значения : 1–31.

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

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

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

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

Возвращает указанную дату (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

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

= DATE(08,1,2)

Годы после 1899

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

= DATE(2008,1,2)

Месяцы

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

= DATE(2008,14,2)

Дни

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

= DATE(2008,1,35)

Связанный контент

Функции даты и времени
Функция DAY
ФУНКЦИЯ TODAY