パラメータ
- year
- 1 〜 9999 の整数の式が必須です。ただし、この範囲より小さい値も指定できます。が 0 〜 99 の場合は、後の「解説」で説明するように 1930 〜 2029 として解釈されます。が 1 より小さい場合は、現在の年から引かれます。
- month
- 1 〜 12 の整数の式が必須です。です。ただし、この範囲外の値も指定できます。の値から 1 が引かれ、計算された年の 1 月に加えられます。つまり、(- 1) が 1 月に加算されます。年は必要に応じて再計算されます。次の結果はこの効果を示しています。 が 1 の場合、結果は計算された年の 1 月です。 が 0 の場合、結果は前年の 12 月です。 が -1 の場合、結果は前年の 11 月です。 が 13 の場合、結果は翌年の 1 月です。
- day
- 1 〜 31 の整数の式が必須です。ただし、この範囲外の値も指定できます。の値から 1 が引かれ、計算された月の第 1 日に加えられます。つまり、(- 1) が月の 1 日に加算されます。月と年は、必要に応じて再計算されます。次の結果はこの効果を示しています。 が 1 の場合、結果は計算された月の 1 日です。 が 0 の場合、結果は前月の末日です。 が -1 の場合、結果は前月の最後から 2 日目です。 が当月の末日を過ぎている場合、結果は翌月の該当日です。たとえば、が 4 でが 31 の場合、結果は 5 月 1 日です。
戻り値の型
時間の情報が午前 0 時 (00:00:00) に設定された、指定の年、月、および日を表す日付の値を返します。