---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideDuration - スコープ指定

# GlideDuration - スコープ指定 {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：7分

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

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

## GlideDuration - GlideDuration() {#ariaid-title2}

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

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

{#r_ScopedGlideDurationGlideDuration__table_vy2_525_jq}

## GlideDuration - GlideDuration(GlideDuration another) {#ariaid-title3}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| another | GlideDuration | GlideDuration オブジェクト。 |
[表 : 2. パラメーター]

{#r_ScopedGlideDurationGlideDuration_GlideDuration__table_vy2_525_jq}  

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

出力:

    3 Days 12 Hours

## GlideDuration - GlideDuration(ミリ秒数) {#ariaid-title4}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| milliseconds | 数値 | 期間の値。 単位：ミリ秒 |
[表 : 3. パラメーター]

{#r_ScopedGlideDurationGlideDuration_Number__table_vy2_525_jq}  

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

出力：

    00:01:00

## GlideDuration - GlideDuration(文字列 displayValue) {#ariaid-title5}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| displayValue | 文字列 | 期間の値。 形式：d HH:mm:ss (「d」は日数)。 |
[表 : 4. パラメーター]

{#r_ScopedGlideDurationGlideDuration_String__table_vy2_525_jq}  

    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 期間) {#ariaid-title6}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| duration | GlideDuration | 現在の GlideDuration オブジェクトに加算する期間値を含む GlideDuration オブジェクト。 |
[表 : 5. パラメーター]

{#r_ScopedGlideDurationAdd_GlideDuration__table_vy2_525_jq} {#r_ScopedGlideDurationAdd_GlideDuration__table_qpt_3f5_jq__entry__2}

| タイプ | 説明 |
|-|-|
| GlideDuration | 期間が 2 つの GlideDuration オブジェクトの期間の合計である新しい GlideDuration オブジェクト。 |
[表 : 6. 返される内容]

{#r_ScopedGlideDurationAdd_GlideDuration__table_qpt_3f5_jq}  

    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(文字列形式) {#ariaid-title7}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| format | 文字列 | 期間の形式。 形式: [グローバル日付/時刻フィールド形式](https://www.servicenow.com/docs/access?context=r_FormatDateAndTimeFields&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US) |
[表 : 7. パラメーター]

{#r_ScopedGlideDurationGetByFormat_String__table_vy2_525_jq} {#r_ScopedGlideDurationGetByFormat_String__table_qpt_3f5_jq__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 指定された形式の現在の期間。 |
[表 : 8. 返される内容]

{#r_ScopedGlideDurationGetByFormat_String__table_qpt_3f5_jq}  

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

出力

    22:00

## GlideDuration - getDayPart() {#ariaid-title8}

日数を返します。
{#r_ScopedGlideDurationGetDayPart__table_vy2_525_jq__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 9. パラメーター]

{#r_ScopedGlideDurationGetDayPart__table_vy2_525_jq} {#r_ScopedGlideDurationGetDayPart__table_qpt_3f5_jq__entry__2}

| タイプ | 説明 |
|-|-|
| 数値 | 期間中の日数。 |
[表 : 10. 返される内容]

{#r_ScopedGlideDurationGetDayPart__table_qpt_3f5_jq}  

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

出力:

    3

## スコープ対象 GlideDuration - getDisplayValue() {#ariaid-title9}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 11. パラメーター]

{#r_ScopedGlideDurationGetDisplayValue__table_vy2_565_jq} {#r_ScopedGlideDurationGetDisplayValue__table_qpt_3f5_jq__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 日数、時間数、および分数 (2 日 10 時間 36 分など)。 形式：表示値：「n」日「n」時「n」分 |
[表 : 12. 返される内容]

{#r_ScopedGlideDurationGetDisplayValue__table_qpt_3f5_jq}  

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

出力:

    3 Days 12 Hours

## GlideDuration - getDurationValue() {#ariaid-title10}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 13. パラメーター]

{#r_ScopedGlideDurationGetDurationValue__table_vy2_565_jq} {#r_ScopedGlideDurationGetDurationValue__table_qpt_3f5_jq__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 期間の値。 形式：d HH:mm:ss (「d」は日数)。 |
[表 : 14. 返される内容]

{#r_ScopedGlideDurationGetDurationValue__table_qpt_3f5_jq}  

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

出力:

    00:01:00

## GlideDuration - getRoundedDayPart() {#ariaid-title11}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 15. パラメーター]

{#r_ScopedGlideDurationGetRoundedDayPart__table_vy2_565_jq} {#r_ScopedGlideDurationGetRoundedDayPart__table_qpt_3f5_jq__entry__2}

| タイプ | 説明 |
|-|-|
| 数値 | 端数処理された表示値の日の値。 |
[表 : 16. 返される内容]

{#r_ScopedGlideDurationGetRoundedDayPart__table_qpt_3f5_jq}  

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

出力:

    4

## GlideDuration - getValue() {#ariaid-title12}

現在の GlideDuration オブジェクトの内部日付/時刻値を返します。
GlideDuration オブジェクトは 1970 年 1 月 1 日 00:00:00 からの日時として期間を格納します。
{#r_ScopedGlideDurationGetValue__table_vy2_565_jq__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 17. パラメーター]

{#r_ScopedGlideDurationGetValue__table_vy2_565_jq} {#r_ScopedGlideDurationGetValue__table_qpt_3f5_jq__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | GlideDuration オブジェクト内の現在の期間。 形式：YYYY-MM-DD HH:mm:ss |
[表 : 18. 返される内容]

{#r_ScopedGlideDurationGetValue__table_qpt_3f5_jq}  

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

出力：

    1970-01-04 12:00:00

## GlideDuration - setDisplayValue(文字列 asDisplayed) {#ariaid-title13}

期間の表示値を設定します。
{#r_ScopedGlideDurationSetDisplayValue_String__table_vy2_525_jq__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| asDisplayed | 文字列 | 設定する表示期間の値。 形式：d HH:mm:ss (「d」は日数) |
[表 : 19. パラメーター]

{#r_ScopedGlideDurationSetDisplayValue_String__table_vy2_525_jq} {#r_ScopedGlideDurationSetDisplayValue_String__table_qpt_3f5_jq1__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 20. 返される内容]

{#r_ScopedGlideDurationSetDisplayValue_String__table_qpt_3f5_jq1}  

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

出力：

    3 Days 8 Hours

## GlideDuration - setValue(オブジェクト o) {#ariaid-title14}

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

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

{#r_ScopedGlideDurationSetValue_Object__table_vy2_525_jq} {#r_ScopedGlideDurationSetValue_Object__table_qpt_3f5_jq1__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 22. 返される内容]

{#r_ScopedGlideDurationSetValue_Object__table_qpt_3f5_jq1}  

    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) {#ariaid-title15}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| duration | GlideDuration | 現在の GlideDuration オブジェクトから減算する期間値を含む GlideDuration オブジェクト。 |
[表 : 23. パラメーター]

{#r_ScopedGlideDurationSubtract_GlideDuration__table_vy2_525_jq} {#r_ScopedGlideDurationSubtract_GlideDuration__table_qpt_3f5_jq1__entry__2}

| タイプ | 説明 |
|-|-|
| GlideDuration | 期間に 2 つの GlideDuration オブジェクトの期間の減算結果が含まれる新しい GlideDuration オブジェクト。 |
[表 : 24. 返される内容]

{#r_ScopedGlideDurationSubtract_GlideDuration__table_qpt_3f5_jq1}  

    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