STARTOFYEAR

применяется:вычисляемый столбецвычисляемой таблицыизмерениевизуального вычисления

Примечание.

Эта функция не рекомендуется использовать в визуальных вычислениях , так как, скорее всего, возвращает бессмысленные результаты.

Для входных данных столбца даты возвращает первую дату года в текущем контексте для указанного столбца дат.
Для входных данных календаря возвращает таблицу для первой даты года в текущем контексте. Таблица содержит все основные помеченные столбцы и все связанные со временем столбцы.

Синтаксис

STARTOFYEAR(<dates> or <calendar>)

Параметры

Термин Определение
dates or calendar Столбец, содержащий даты или ссылку на календарь.
YearEndDate (Необязательно) Значение даты окончания года. Применяется только для входных данных столбца даты.

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

Для ввода столбца даты таблица, содержащая один столбец и одну строку со значением даты.
Для входных данных календаря таблица для первой даты года в текущем контексте. Таблица содержит все основные помеченные столбцы и все связанные со временем столбцы.

Замечания

  • Аргумент dates может быть одним из следующих:

    • Ссылка на столбец даты и времени.
    • Табличное выражение, возвращающее один столбец значений даты и времени.
    • Логическое выражение, определяющее таблицу значений даты и времени с одним столбцом.
  • Ограничения логических выражений описаны в разделе CALCULATE.

  • Параметр year_end_date не должен быть указан при использовании календаря.

  • Эта функция не поддерживается для использования в режиме DirectQuery при использовании в вычисляемых столбцах или правилах безопасности на уровне строк (RLS).

Пример

В следующем примере формулы создается мера, которая возвращает начало года для текущего контекста.

= STARTOFYEAR(DateTime[DateKey])

Пример для аналитики времени на основе календаря

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

= STARTOFYEAR(FiscalCalendar)