年、月、日で指定した日付に対するDateTimeオブジェクトを返します。
DATE(year,month,day)
有効な引数は次のとおりです。
引数 | 説明 |
---|---|
year | 年を表す4桁の数値(1から9999)。整数以外の値を指定すると、小数部分が切り捨てられます。 |
month | 月を表す数値。整数以外の値を指定すると、小数部分が切り捨てられます。 |
day | 日を表す数値。整数以外の値を指定すると、小数部分が切り捨てられます。 |
monthに12より大きい数値を指定すると、月数は12を超えて増加するので、必要に応じて年が繰り上がります。 たとえばDATE(2003,16,2)と指定すると、2004年4月2日を表すDateTimeオブジェクトが返されます。
指定の月の日数より大きな数値をdayに指定すると、日数はその月末を超え、翌月の1日以降に繰り上がります。 たとえばDATE(2004,1,35)と指定すると、2004年2月4日を表すDateTimeオブジェクトが返されます。
各引数に整数以外の値を指定すると、小数部分が切り捨てられます。 monthに負数を指定すると、月数がその分前年にさかのぼります。 dayに負数を指定すると、日数がその分前月にさかのぼります。
数値データを受け取り、 DateTimeオブジェクトを返します。
DATE(A1,B1,C1)
DATE(R1C1,R1C2,R1C3)
DATE(2003,1,1) 結果: January 1, 2003
DATE(2004,2,10) 結果: February 10, 2004