다음을 통해 공유


STARTOFYEAR

적용 대상:계산 열계산 테이블측정값시각적 계산

참고 항목

이 함수는 의미 없는 결과를 반환할 가능성이 있으므로 시각적 계산에 사용하지 않는 것이 좋습니다.

날짜 열 입력의 경우 지정된 날짜 열의 현재 컨텍스트에서 연도의 첫 번째 날짜를 반환합니다.
달력 입력의 경우 현재 컨텍스트에서 연도의 첫 번째 날짜에 대한 테이블을 반환합니다. 테이블에는 모든 기본 태그가 지정된 열과 모든 시간 관련 열이 포함됩니다.

구문

STARTOFYEAR(<dates> or <calendar>)

매개 변수

용어 정의
dates or calendar 날짜 또는 달력 참조가 포함된 열입니다.
YearEndDate (선택 사항) 연도 종료 날짜 값입니다. 날짜 열 입력에만 적용됩니다.

반환 값

날짜 열 입력의 경우 단일 열과 날짜 값이 있는 단일 행이 포함된 테이블입니다.
달력 입력의 경우 현재 컨텍스트에서 연도의 첫 번째 날짜에 대한 테이블입니다. 테이블에는 모든 기본 태그가 지정된 열과 모든 시간 관련 열이 포함됩니다.

설명

  • dates 인수는 다음 중 어느 것이든 될 수 있습니다.

    • 날짜/시간 열에 대한 참조입니다.
    • 날짜/시간 값의 단일 열을 반환하는 테이블 식입니다.
    • 날짜/시간 값의 단일 열 테이블을 정의하는 부울 식입니다.
  • 부울 식에 대한 제약 조건은 CALCULATE항목에 설명되어 있습니다.

  • 달력을 사용할 때 매개 year_end_date 변수를 지정해서는 안 됩니다.

  • 이 함수는 계산 열 또는 RLS(행 수준 보안) 규칙에서 사용되는 경우 DirectQuery 모드에서 사용할 수 없습니다.

예시

다음 샘플 수식은 현재 컨텍스트에 대해 연초의 시작을 반환하는 측정값을 만듭니다.

= STARTOFYEAR(DateTime[DateKey])

일정 기반 시간 인텔리전스의 예

다음 샘플 수식은 회계 달력에 대해 연초에 해당하는 태그가 지정된 열을 반환하는 테이블을 만듭니다.

= STARTOFYEAR(FiscalCalendar)

날짜 및 시간 함수시간 인텔리전스 함수STARTOFQUARTERSTARTOFMONTHSTARTOFWEEK