GlideDuration :スコープ対象

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：7分

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

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

    GlideDuration:GlideDuration()

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

    表 : 1. パラメーター
    名前 タイプ 説明
    なし

    GlideDuration:GlideDuration(GlideDuration:別の)

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

    表 : 2. パラメーター
    名前 タイプ 説明
    その他 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(ミリ秒数)

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

    表 : 3. パラメーター
    名前 タイプ 説明
    ミリ秒 番号 期間の値。

    単位：ミリ秒

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

    出力:

    00:01:00

    GlideDuration:GlideDuration(文字列 displayValue)

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

    表 : 4. パラメーター
    名前 タイプ 説明
    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:add(GlideDuration duration)

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

    表 : 5. パラメーター
    名前 タイプ 説明
    duration GlideDuration 現在の GlideDuration オブジェクトに追加する期間の値を含む GlideDuration オブジェクト。
    表 : 6. 返される内容
    タイプ 説明
    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(文字列形式)

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

    表 : 7. パラメーター
    名前 タイプ 説明
    format 文字列 期間形式。

    形式: グローバル日付/時刻フィールド形式
    表 : 8. 返される内容
    タイプ 説明
    文字列 指定された形式の現在の期間。 
    var dur = new GlideDuration('3 22:00:00');
gs.info(dur.getByFormat('HH:mm'));

    出力

    22:00

    GlideDuration:getDayPart()

    日数を返します。

    表 : 9. パラメーター
    名前 タイプ 説明
    なし
    表 : 10. 返される内容
    タイプ 説明
    番号 期間の日数。 
    var dur = new GlideDuration('3 12:00:00');
gs.info(dur.getDayPart());

    出力:

    3

    スコープ対象 GlideDuration:getDisplayValue()

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

    表 : 11. パラメーター
    名前 タイプ 説明
    なし
    表 : 12. 返される内容
    タイプ 説明
    文字列 日数、時間数、分数 (2 日 10 時間 36 分など)。

    形式: 表示値:「n」日「n」時間「n」分

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

    出力:

    3 Days 12 Hours

    GlideDuration:getDurationValue()

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

    表 : 13. パラメーター
    名前 タイプ 説明
    なし
    表 : 14. 返される内容
    タイプ 説明
    文字列 期間の値。

    形式:d HH:mm:ss ここで、「d」は日数です。

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

    出力:

    00:01:00

    GlideDuration:getRoundedDayPart()

    丸められた日数を返します。時間部分が 12 時間を超える場合、戻り値は切り上げられます。それ以外の場合は切り捨てられます。

    表 : 15. パラメーター
    名前 タイプ 説明
    なし
    表 : 16. 返される内容
    タイプ 説明
    番号 丸められた表示値の日値。 
    var dur = new GlideDuration('3 14:00:00');
gs.info(dur.getRoundedDayPart());

    出力:

    4

    GlideDuration:getValue()

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

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

    表 : 17. パラメーター
    名前 タイプ 説明
    なし
    表 : 18. 返される内容
    タイプ 説明
    文字列 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: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