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