#年([<値>])

値から年の部分を取り出します。または年数を求めます。

構文

#年([<値>])

#YEAR([<値>])

引数

<値>

日付型または年月間隔型の値を与えます。省略したときは今年とみなされます。

例

#年(#日付('1986/6/1'))	→	1986
#年(#年月間隔('3年6ヵ月'))	→	3.5
#年(#年月間隔(30))	→	2.5

解説

• <値> は日付型または年月間隔型でなければなりません。日付型のときは，<値> から年のみを取り出します。年月間隔型のときは <値> を年数に変換します。このとき，６ヵ月を 0.5 年に換算して月数も考慮して計算されます。

戻り値

• <値> が日付型のときはその西暦年を整数型で返します。<値> が年月間隔型のときは年数を数値型で返します。<値> を省略したときは現在の西暦年を整数型で返します。
• 西暦年の紀元 1 年は 1 ですが，その前年の紀元前 1 年は 0，紀元前 2 年は -1 となります。

関連項目

#月

#日

#うるう年か