YEAR 関数は日付、又は時間軸を数値形式の年に変換します。 

この関数を使えば、複数の年を比較してそれらが同じかどうかを簡単に確認できます。 

YEAR(Value to convert, [Time period method]) 

引数データ型説明
Value to convert日付、時間軸数値としての年に変換する日付または時間軸
Time period method (オプション)キーワード年を時間軸の最初、真ん中、最後のうちのどこから抽出するかを指定

Time period method 引数のキーワードは以下のとおりです。

  • START (デフォルトの方法): 時間軸の最初の日付がある年を返す
  • MID: 時間軸の真ん中に位置する日付がある年を返す
  • END: 時間軸の最後の日付がある年を返す

YEAR 関数は数値を返します。 

この例では、ライン アイテム「Date」が日付形式になっています。ライン アイテム「Number」では、式 YEAR(Date) を使用して年の数値形式を返します。


Jan 25Feb 25Mar 25Apr 25May 25
Date01/01/202502/02/202503/03/202504/04/202505/05/2025
数値
YEAR(Date)
2,0252,0252,0252,0252,025

この例では、「Months」というプロパティがあるリストによってターゲット モジュールがディメンション化されています。これはグリッド ビューで表示されているとおりのリストです。


コード
1

Dec 21
2

Jan 21
3

Sep 22
4

Jul 24
5

Dec 23

ライン アイテム「Input」は単位の時間軸形式で、リストから「Months」リスト アイテムを返す式 List.Months があります。 ライン アイテム「Number」では、式 YEAR(Input) を使用して年の数値形式を返します。


12345
Input
List.Months
Dec 25Jan 21Sep 22Jul 24Dec 23
数値
YEAR(Input)
2,0252,0212,0222,0242,023

以下は YEAR(Value to convert) の例を示したものです。変換対象の値が「Product date」ライン アイテムと「Year period」ライン アイテムから取得されています。それぞれ日付形式と時間軸形式になっています。 


Key datesExpiry dates
Product released16/02/201623/08/2017
Year period Feb 16Aug 17

Product year

YEAR(Product released)

2,0162,017

Year number

YEAR(Year period)

2,0162,017

2 番目は YEAR(TIME. 'Period') の例を示したものです。ライン アイテムの代わりに明示的な時間参照を使用しています。 


Key dates

Year Number 

YEAR(TIME.'Apr 16')

2,016

最後が Time period method 引数の効果の例を示したものです。明示的な時間参照とキーワードを使用することで、年の抽出元となる時間軸の日付を指定しています。


Product:Plums
Start of fiscal yearWeek 1 FY2019

Year Start

YEAR(Start of fiscal year, START)

2,018

Year Mid

YEAR(TIME.'FY19', MID)

2,019

Year End

YEAR(Start of fiscal year, END)

2,019