---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideDuration - 범위 지정

# GlideDuration - 범위 지정 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](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 기타) {#ariaid-title3}

전달된 GlideDuration 객체의 값을 복제하여 GlideDuration 객체를 인스턴스화합니다.
{#r_ScopedGlideDurationGlideDuration_GlideDuration__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 다른 | 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}

| 이름 | 유형 | 설명 |
|-|-|-|
| 밀리초 | 번호 | 지속 시간 값입니다. 단위: 밀리초 |
[표 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}

| 이름 | 유형 | 설명 |
|-|-|-|
| 기간 | GlideDuration | 현재 GlideDuration 객체에 추가할 기간 값이 포함된 GlideDuration 객체입니다. |
[표 5. 매개변수]

{#r_ScopedGlideDurationAdd_GlideDuration__table_vy2_525_jq} {#r_ScopedGlideDurationAdd_GlideDuration__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| GlideDuration | 지속 시간이 두 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=australia&pubname=australia-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 - 빼기(GlideDuration 기간) {#ariaid-title15}

지정된 GlideDuration 객체의 기간을 현재 GlideDuration 객체에서 뺍니다.
{#r_ScopedGlideDurationSubtract_GlideDuration__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 기간 | GlideDuration | 현재 GlideDuration 객체에서 뺄 기간 값이 포함된 GlideDuration 객체입니다. |
[표 23. 매개변수]

{#r_ScopedGlideDurationSubtract_GlideDuration__table_vy2_525_jq} {#r_ScopedGlideDurationSubtract_GlideDuration__table_qpt_3f5_jq1__entry__2}

| 유형 | 설명 |
|-|-|
| GlideDuration | 지속 기간에 두 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