GlideDuration - スコープ対象

GlideDuration クラスは期間と呼ばれる時間のスパンを操作するメソッドを提供します。

GlideDuration オブジェクトは 1970 年 1 月 1 日 00:00:00 からの日時として期間を格納します。そのため、setValue() と getValue() は、パラメーターと戻り値にスコープ対象の GlideDateTime オブジェクトを使用します。

スコープ対象 GlideDuration - add(GlideDuration duration)

指定された GlideDuration オブジェクトの期間を現在の GlideDuration オブジェクトに加算します。

表 : 1. パラメーター

名前	タイプ	説明
duration	GlideDuration	現在の GlideDuration オブジェクトに加算する期間値を含む GlideDuration オブジェクト。

表 : 2. 返される内容

タイプ	説明
GlideDuration	期間が 2 つの GlideDuration オブジェクトの期間の合計である新しい GlideDuration オブジェクト。

var duration = new GlideDuration('3 12:00:00');
var duration2 = new GlideDuration('3:00:00');
var answer = duration.add(duration2);
gs.info(answer.getDisplayValue());

出力:

3 Days 15 Hours

スコープ対象 GlideDuration - getByFormat(文字列 format)

指定された形式で期間の値を返します。

表 : 3. パラメーター

名前	タイプ	説明
format	文字列	期間の形式。 形式: グローバル日付/時刻フィールド形式

表 : 4. 返される内容

タイプ	説明
文字列	指定された形式の現在の期間。

var dur = new GlideDuration('3 22:00:00');
gs.info(dur.getByFormat('HH:mm'));

出力

22:00

スコープ対象 GlideDuration - getDayPart()

日数を返します。

表 : 5. パラメーター

名前	タイプ	説明
なし

表 : 6. 返される内容

タイプ	説明
数値	期間中の日数。

var dur = new GlideDuration('3 12:00:00');
gs.info(dur.getDayPart());

出力

3

スコープ対象 GlideDuration - getDisplayValue()

期間の表示値を日数、時間数、および分数で返します。

表 : 7. パラメーター

名前	タイプ	説明
なし

表 : 8. 返される内容

タイプ	説明
文字列	日数、時間数、および分数 (2 日 10 時間 36 分など)。 形式：表示値：「n」日「n」時「n」分

var dur = new GlideDuration('3 12:00:00');
gs.info(dur.getDisplayValue());

出力

3 Days 12 Hours

スコープ対象 GlideDuration - GlideDuration()

GlideDuration オブジェクトをインスタンス化します。

表 : 9. パラメーター

名前	タイプ	説明
なし

スコープ対象 GlideDuration - getDurationValue()

「d HH:mm:ss」形式で期間の値を返します。

表 : 10. パラメーター

名前	タイプ	説明
なし

表 : 11. 返される内容

タイプ	説明
文字列	期間の値。 形式：d HH:mm:ss (「d」は日数)。

var dur = new GlideDuration(60000);
gs.info(dur.getDurationValue());

出力

00:01:00

スコープ対象 GlideDuration - getRoundedDayPart()

端数処理した日数を返します。時間部分が 12 時間を超える場合、戻り値は切り上げられます。超えない場合は切り捨てられます。

表 : 12. パラメーター

名前	タイプ	説明
なし

表 : 13. 返される内容

タイプ	説明
数値	端数処理された表示値の日の値。

var dur = new GlideDuration('3 14:00:00');
gs.info(dur.getRoundedDayPart());

出力

4

スコープ対象 GlideDuration - getValue()

現在の GlideDuration オブジェクトの内部日付/時刻値を返します。

GlideDuration オブジェクトは 1970 年 1 月 1 日 00:00:00 からの日時として期間を格納します。

表 : 14. パラメーター

名前	タイプ	説明
なし

表 : 15. 返される内容

タイプ	説明
文字列	GlideDuration オブジェクト内の現在の期間。 形式：YYYY-MM-DD HH:mm:ss

var dur = new GlideDuration('3 12:00:00');
gs.info(dur.getValue());

出力：

1970-01-04 12:00:00

スコープ対象 GlideDuration - GlideDuration(GlideDuration another)

渡された GlideDuration オブジェクトの値のクローンを作成して、GlideDuration オブジェクトをインスタンス化します。

表 : 16. パラメーター

名前	タイプ	説明
another	GlideDuration	GlideDuration オブジェクト。

var duration = new GlideDuration('3 12:00:00');
var duration2 = new GlideDuration(duration);
gs.info(duration2.getDisplayValue());

出力

3 Days 12 Hours

スコープ対象 GlideDuration - GlideDuration(数値 milliseconds)

指定された期間 (ミリ秒) で GlideDuration オブジェクトをインスタンス化します。

表 : 17. パラメーター

名前	タイプ	説明
milliseconds	数値	期間の値。 単位：ミリ秒

var dur = new GlideDuration(60000);
gs.info(dur.getDurationValue());

出力

00:01:00

スコープ対象 GlideDuration - GlideDuration(文字列 displayValue)

指定された期間の表示値で GlideDuration オブジェクトをインスタンス化します。

表 : 18. パラメーター

名前	タイプ	説明
displayValue	文字列	期間の値。 形式：d HH:mm:ss (「d」は日数)。

var duration = new GlideDuration('3 12:00:00');
var duration2 = new GlideDuration('3:00:00');
var answer = duration.add(duration2);
gs.info(answer.getDisplayValue());

出力

3 Days 15 Hours

スコープ対象 GlideDuration - setDisplayValue(文字列 asDisplayed)

期間の表示値を設定します。

表 : 19. パラメーター

名前	タイプ	説明
asDisplayed	文字列	設定する表示期間の値。 形式：d HH:mm:ss (「d」は日数)

表 : 20. 返される内容

タイプ	説明
なし

var dur = new GlideDuration(); 
dur.setDisplayValue('3 08:00:00');
gs.info(dur.getDisplayValue());

出力

3 Days 8 Hours

スコープ対象 GlideDuration - setValue(オブジェクト o)

GlideDuration オブジェクトの内部日付/時刻値を設定します。

このメソッドは 1970 年 1 月 1 日 00:00:00 に渡された日付/時刻値の差を期間値に設定します。渡された日付/時刻オブジェクト (文字列) は GlideDateTime オブジェクトに解析されます。

表 : 21. パラメーター

名前	タイプ	説明
o	オブジェクト	計算された期間のエンドポイントとして使用する日時。 形式：YYYY-MM-DD HH:mm:ss

表 : 22. 返される内容

タイプ	説明
なし

var dur = new GlideDuration();
dur.setValue('1970-01-05 08:00:00'); // sets internal DateTime value. The String is parsed into a GlideDateTime object.
gs.info(dur.getDisplayValue());

出力：

4 Days 8 Hours

スコープ対象 GlideDuration - subtract(GlideDuration duration)

指定された GlideDuration オブジェクトの期間を現在の GlideDuration オブジェクトから減算します。

表 : 23. パラメーター

名前	タイプ	説明
duration	GlideDuration	現在の GlideDuration オブジェクトから減算する期間値を含む GlideDuration オブジェクト。

表 : 24. 返される内容

タイプ	説明
GlideDuration	期間に 2 つの GlideDuration オブジェクトの期間の減算結果が含まれる新しい GlideDuration オブジェクト。

var duration = new GlideDuration('3 12:00:00');
var duration2 = new GlideDuration('3:00:00');
var answer = duration.subtract(duration2);
gs.info(answer.getDisplayValue());

出力：

3 Days 9 Hours