SpreadJS製品ヘルプ
DATE
関数リファレンス > 関数の一覧 > 日付と時刻の関数 > DATE

年、月、日で指定した日付に対する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

関連トピック