指定した日付に指定した月数を加算します。

構文

AddMth(date-expression | datetime-expression , numeric-expression)



入力値の説明:

date-expression | datetime-expression
   任意の日付または日時です。
numeric-expression
   date-expression または datetime-expression に加算する月数です。


戻されるタイプ:
Date | DateTime

適用範囲

オブジェクト: Procedure、Transaction、Web Panel、 Panel、Data Provider

説明

numeric-expression による月数を date-expression または datetime-expression に加えた結果の値を戻します。割り当てられたタイプが日付の場合は日付を、日時の場合は日時を戻します。
数値式がマイナスの場合は、日付から月数を減算します。

例

Date1 = ADDMTH(Today(),2) // Today() = 31/03/2008
// 結果: Date1 = 31/05/2008、Date1 が date タイプの項目属性の場合

Date2 = ADDMTH(Today(),1) // Today() = 31/03/2008
// 結果: Date2 = 30/04/2008 00:00:00、Date2 が datetime タイプの項目属性の場合

Date3 = ADDMTH(Date2,1) // Date2 = 30/04/2008
// 結果: Date3 = 30/05/2008、Date3 が date タイプの項目属性の場合

Date4 = ADDMTH(Today(),-2) // Today() = 21/09/2008
// 結果: Date4 = 21/07/2008、Date2 が date タイプの項目属性の場合

Date5 = ADDMTH(Now(),1) // Now() = 21/08/2008 16:30:12
// 結果: Date5 = 21/09/2008、Date5 が date タイプの項目属性の場合
// 結果: Date5 = 21/09/2008 16:30:12、Date5 が datetime タイプの項目属性の場合 

Date1 に対応する結果の値は Date3 における結果とは異なります。つまり、ある日付に 2 か月を加算した場合 (Date1) と、同じ日付に 1 か月を 2 回加算した場合 (Date2 および Date3) とでは結果が異なることがあります。任意の日付から月数を減算することもできます (例: Date4)。

 

参考情報

AddMonths メソッド
AddYr 関数
AddDays メソッド