月を追加
指定された日付と時刻より指定された月数前または後の月の UTC 日付と時刻を返します。
構文
AddMonths(numMonths、baseDateTime、timeZone) を追加します。有効
ビジネス オブジェクト カテゴリの説明については、「有効な対象」に関する注意事項 ( 「有効」に関する注意事項
ビジネスオブジェクトカテゴリ | はい/いいえ |
|---|---|
ビジネスルール: 保存前ルール | はい |
ビジネス ルール: 計算ルール (保存後、ロード時に再計算の有無) | はい |
ビジネス ルール: 計算ルール (保存前または常に、読み込み時に再計算なし) | はい |
ビジネス ルール: 計算ルール (保存前または常に、読み込み時に再計算) | はい |
ビジネスルール: ルールの編集 | はい |
ビジネスルール: 初期化ルール | はい |
ビジネスルール: 読み取り専用ルール | はい |
ビジネスルール: 必須ルール | はい |
ビジネスルール: 検証ルール | はい |
クライアントの表現 | はい |
オブジェクトの権限 | はい |
サービス | はい |
LDAP の | はい |
携帯 | はい |
クイックアクション(UI クイックアクションを除く) | はい |
UI クイックアクション | はい |
レポート | はい |
フィールド参照のない検索/ダッシュボード | はい |
フィールド参照付き検索/ダッシュボード | はい |
パラメータ
パラメータ | 説明 |
|---|---|
月数 | (オプション) 間隔の数。 指定されていない場合は、デフォルトの間隔である 0 が使用されます。 将来の月を示す正の整数、または過去の月を示す負の整数のいずれかになります。 |
ベース日付時刻 | (オプション) 関数の基準日。 指定されていない場合は、現在の日付と時刻であるデフォルトの日付が使用されます。 |
タイムゾーン | (オプション) IANA 形式のタイムゾーン。 |
返品
UTC 時間の DateTime 値。
- アプリケーションが戻り値を表示する必要がある場合、戻り値は暗黙的にテキストに変換され、カルチャ コードに応じて表示形式が変更されます。 サービス マネージャで使用されるカルチャ コードの一覧については、「 利用可能な言語と文化 」を参照してください。
- 戻り値が有効な日付でない場合、関数はその月の最終日を返します。 たとえば、次の関数: $(AddMonths(4, mydate))では、 mydate パラメータの値が 2014 年 10 月 31 日である場合、この関数は 2015 年 2 月 31 日を返しますが、これは有効な日付ではないため、関数は月の最終日である 2015 年 2 月 28 日を返します。
例
$(AddMonths(4))今日が 2014 年 4 月 10 日の場合、この関数は 2014 年 8 月 10 日の同じ時刻の DateTime 値を返します。
$(AddMonths(3, mydate))mydate パラメータの値が 2014 年 4 月 10 日の場合、この関数は 3 か月後の 2014 年 7 月 10 日の同じ時刻の DateTime 値を返します。
$(AddMonths(-1, mydate))mydate パラメータの値が 2014 年 4 月 10 日の場合、この関数は 2014 年 3 月 10 日の同じ時刻の DateTime 値を返します。
