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

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideTime - 범위 지정

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

* 릴리스 버전: Xanadu
* 
* 업데이트 날짜 2024년 08월 01일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 6분

GlideTime API는 GlideTime 객체 인스턴스화 또는 GlideTime 필드 작업 등, GlideTime 객체에 대한 작업을 수행하기 위한 메서드를 제공합니다.
일반적인 형식 충돌 목록이 있는 날짜 시간 입력 문자열에 대한 지침은 을 [날짜 및 시간 형식 가이드라인](https://servicenow-prod.fluidtopics.net/93DaUA95gYDslZE_1PT~0A#date-and-time-format-guidelines "특정 날짜 및 시간 패턴 문자열의 시퀀스로 날짜 형식을 지정할 수 있습니다. 패턴 문자열은 A에서 Z까지 하나 이상의 대문자와 소문자로 구성됩니다. 따옴표 안의 텍스트는 무시되고 대신 날짜 출력에 복사됩니다.")참조하십시오.

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

현재 시간으로 GlideTime 객체를 인스턴스화합니다.
{#r_ScopedGlideTimeGlideTime__table_cxr_tsb_2r__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 1. 매개변수]

{#r_ScopedGlideTimeGlideTime__table_cxr_tsb_2r}  

    var gt = new GlideTime(); 
    gs.info(gt.getDisplayValue());

## GlideTime - GlideTime(밀리초 수) {#ariaid-title3}

자정(UTC)에 시작하는 시간과 전달된 값으로 GlideTime 객체를 인스턴스화합니다.
이 값은 인스턴스가 위치한 시간대에 맞게 조정됩니다. 예를 들어 사용자의 인스턴스가 UTC에서 -8시간인 표준 시간대에 있고 1000이 전달되는 경우 GlideTime 개체의 시간은 16:00:10(00:00:00 - 8시간 +10초)입니다.
{#r_ScopedGlideTimeGlideTime_Number__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 밀리초 | 번호 | UTC 자정에 추가할 시간입니다. 단위: 밀리초 |
[표 2. 매개변수]

{#r_ScopedGlideTimeGlideTime_Number__table_vy2_525_jq}  
이 예제에서는 자정(UTC)에 10초를 추가한 다음 인스턴스가 상주하는 시간대에 맞게 조정되는 방법을 보여줍니다. 이 경우 UTC에서 -8시간입니다.

    var gt = new GlideTime(10000); 
    gs.info(gt.getDisplayValue());

출력:

    16:00:10

## GlideTime - getByFormat(문자열 형식) {#ariaid-title4}

지정된 형식으로 시간을 반환합니다.
이 메서드에 전달할 수 있는 시간 형식에 대한 자세한 내용은 [전역 날짜 및 시간 필드 형식을](https://www.servicenow.com/docs/access?context=r_FormatDateAndTimeFields&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US) 참조하십시오. 이러한 값을 순서에 관계없이 전달하고 대시, 공백, 백슬래시 또는 콜론과 같은 구분 기호를 추가할 수 있습니다. 또한 문자 "a"를 전달하여 am/pm을 반환할 수도 있습니다.
{#r_ScopedGlideTimeGetByFormat_String__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| format | 문자열 | 시간 형식을 지정하는 데 사용할 문자열입니다. 예를 들어 현재 시간이 10:30:20이면 다음과 같습니다. * hh:mm:ss = 10:30:20 * HH = 10 * HH --- ss = 10 --- 20 * hh a = 오전 10시 * s:m:H ss:mm:hh = 20:30:10 20:30:10 * HH:mm:ss입니다. SSSZ = 10:30:20.000+0000 * HH/밀리미터 / ss = 10/30/20 {#r_ScopedGlideTimeGetByFormat_String__ul_cdw_4zy_jkb} |
[표 3. 매개변수]

{#r_ScopedGlideTimeGetByFormat_String__table_vy2_525_jq} {#r_ScopedGlideTimeGetByFormat_String__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 지정된 형식의 시간입니다. |
[표 4. 반환]

{#r_ScopedGlideTimeGetByFormat_String__table_qpt_3f5_jq}  

    var gt = new GlideTime(); 
    gt.setValue('12:00:00');
    gs.info(gt.getByFormat("HH:mm"));

출력:

    12:00

## GlideTime - getDisplayValue() {#ariaid-title5}

현재 사용자의 표시 형식 및 시간대로 시간을 가져옵니다.
비즈니스 규칙 또는 스크립트 포함을 디자인할 때 이 방법은 사용자마다 다른 형식으로 값을 반환할 수 있습니다.
{#r_ScopedGlideTimeGetDisplayValue__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 5. 매개변수]

{#r_ScopedGlideTimeGetDisplayValue__table_vy2_525_jq} {#r_ScopedGlideTimeGetDisplayValue__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 사용자의 형식 및 시간대의 시간입니다. |
[표 6. 반환]

{#r_ScopedGlideTimeGetDisplayValue__table_qpt_3f5_jq}  

    var gt = new GlideTime();
    gt.setDisplayValue("12:00:00"); // User Time Zone
    gs.info(gt.getDisplayValue()); // User Time Zone

## GlideTime - getDisplayValueInternal() {#ariaid-title6}

현재 사용자의 시간대 및 내부 형식(HH:mm:ss)의 표시 값을 가져옵니다.
{#r_ScopedGlideTimeGetDisplayValueInternal__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 7. 매개변수]

{#r_ScopedGlideTimeGetDisplayValueInternal__table_vy2_525_jq} {#r_ScopedGlideTimeGetDisplayValueInternal__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 현재 사용자의 시간대에 있는 GlideTime 객체의 시간 값과 내부 시간 형식인 HH:mm:ss입니다. |
[표 8. 반환]

{#r_ScopedGlideTimeGetDisplayValueInternal__table_qpt_3f5_jq}  

    var gt = new GlideTime();
    gt.setValue("01:00:00"); //Internal Time Zone , UTC
    gs.info(gt.getDisplayValueInternal()); //User Time Zone

## GlideTime - getHourLocalTime() {#ariaid-title7}

현지 시간대를 사용하여 시간의 시간 부분을 반환합니다.
{#r_SGT-getHourLocalTime__table_pwr_c2d_kw__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 9. 매개변수]

{#r_SGT-getHourLocalTime__table_pwr_c2d_kw} {#r_SGT-getHourLocalTime__table_qwr_c2d_kw__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | 현지 시간대를 사용하는 시간입니다. |
[표 10. 반환]

{#r_SGT-getHourLocalTime__table_qwr_c2d_kw}

## GlideTime - getHourOfDayLocalTime() {#ariaid-title8}

현지 시간대를 사용하여 시간의 시간 부분을 반환합니다. 시간 수는 24시간제를 기준으로 합니다.
{#r_SGT-getHourOfDayLocalTime__table_lrw_4dd_kw__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 11. 매개변수]

{#r_SGT-getHourOfDayLocalTime__table_lrw_4dd_kw} {#r_SGT-getHourOfDayLocalTime__table_mrw_4dd_kw__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | 현지 시간대를 사용하는 시간입니다. 시간 수는 24시간제를 기준으로 합니다. |
[표 12. 반환]

{#r_SGT-getHourOfDayLocalTime__table_mrw_4dd_kw}

## GlideTime - getHourOfDayUTC() {#ariaid-title9}

UTC 시간대를 사용하여 시간의 시간 부분을 반환합니다. 시간 수는 24시간제를 기준으로 합니다.
{#r_SGT-getHourOfDayUTC__table_bv5_zxc_kw__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 13. 매개변수]

{#r_SGT-getHourOfDayUTC__table_bv5_zxc_kw} {#r_SGT-getHourOfDayUTC__table_cv5_zxc_kw__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | UTC 시간대를 사용하는 시간입니다. 시간 수는 24시간제를 기준으로 합니다. |
[표 14. 반환]

{#r_SGT-getHourOfDayUTC__table_cv5_zxc_kw}

## GlideTime - getHourUTC() {#ariaid-title10}

UTC 시간대를 사용하여 시간의 시간 부분을 반환합니다. 시간 수는 12시간제를 기준으로 합니다. 정오와 자정은 12가 아닌 0으로 표시됩니다.
{#r_SGT-getHourUTC__table_cfh_nyc_kw__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 15. 매개변수]

{#r_SGT-getHourUTC__table_cfh_nyc_kw} {#r_SGT-getHourUTC__table_dfh_nyc_kw__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | UTC 시간대를 사용하는 시간입니다. 시간 수는 12시간제를 기준으로 합니다. 정오와 자정은 12가 아닌 0으로 표시됩니다. |
[표 16. 반환]

{#r_SGT-getHourUTC__table_dfh_nyc_kw}

## GlideTime - getMinutesLocalTime() {#ariaid-title11}

현지 시간대를 사용하여 분 수를 반환합니다.
{#r_SGT-getMinutesLocalTime__table_gx3_q2d_kw__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 17. 매개변수]

{#r_SGT-getMinutesLocalTime__table_gx3_q2d_kw} {#r_SGT-getMinutesLocalTime__table_hx3_q2d_kw__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | 현지 시간대를 사용하는 분 수입니다. |
[표 18. 반환]

{#r_SGT-getMinutesLocalTime__table_hx3_q2d_kw}

## GlideTime - getMinutesUTC() {#ariaid-title12}

UTC 시간대를 기준으로 시간 중의 분 수를 반환합니다.
{#r_SGT-getMinutesUTC__table_qvr_xcd_kw__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 19. 매개변수]

{#r_SGT-getMinutesUTC__table_qvr_xcd_kw} {#r_SGT-getMinutesUTC__table_rvr_xcd_kw__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | UTC 시간대를 사용하는 시간 중의 분 수입니다. |
[표 20. 반환]

{#r_SGT-getMinutesUTC__table_rvr_xcd_kw}

## GlideTime - getSeconds() {#ariaid-title13}

현재 분의 초 수를 반환합니다.
{#r_SGT-getSeconds__table_dkh_1fd_kw__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 21. 매개변수]

{#r_SGT-getSeconds__table_dkh_1fd_kw} {#r_SGT-getSeconds__table_ekh_1fd_kw__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | 분으로 된 시간(초)입니다. |
[표 22. 반환]

{#r_SGT-getSeconds__table_ekh_1fd_kw}

## GlideTime - getValue() {#ariaid-title14}

내부 형식, HH:mm:ss 및 시스템 시간대의 GlideTime 객체에 의해 데이터베이스에 저장된 시간 값을 가져옵니다.
{#r_ScopedGlideTimeGetValue__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 23. 매개변수]

{#r_ScopedGlideTimeGetValue__table_vy2_525_jq} {#r_ScopedGlideTimeGetValue__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 내부 폼 및 시스템 시간대의 시간 값입니다. |
[표 24. 반환]

{#r_ScopedGlideTimeGetValue__table_qpt_3f5_jq}  

    var gt = new GlideTime();
    gs.info(gt.getValue()); // Internal Time Zone, UTC

## GlideTime - setDisplayValue(String asDisplayed) {#ariaid-title15}

현재 사용자의 표시 형식과 시간대를 사용하여 시간 값을 설정합니다.
{#r_ScopedGlideTimeSetDisplayValue_String__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| asDisplayed로 | 문자열 | 현재 사용자의 표시 형식 및 시간대로 나타낸 시간입니다. 매개 변수는 현재 사용자가 선호하는 표시 형식(예: HH:mm:ss)을 사용하여 형식을 지정해야 합니다. |
[표 25. 매개변수]

{#r_ScopedGlideTimeSetDisplayValue_String__table_vy2_525_jq} {#r_ScopedGlideTimeSetDisplayValue_String__table_qpt_3f5_jq1__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 26. 반환]

{#r_ScopedGlideTimeSetDisplayValue_String__table_qpt_3f5_jq1}  

    var gt = new GlideTime();
    gt.setDisplayValue('01:00:00');   // User Time Zone
    gs.info(gt.getDisplayValueInternal()); // User Time Zone

## GlideTime - setValue(문자열 o) {#ariaid-title16}

내부 시간대에 있는 GlideTime 객체의 시간을 설정합니다.
{#r_ScopedGlideTimeSetValue_String__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| o | 문자열 | hh:mm:ss 형식의 시간입니다. |
[표 27. 매개변수]

{#r_ScopedGlideTimeSetValue_String__table_vy2_525_jq} {#r_ScopedGlideTimeSetValue_String__table_qpt_3f5_jq1__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 28. 반환]

{#r_ScopedGlideTimeSetValue_String__table_qpt_3f5_jq1}  

    var gt = new GlideTime();
    gt.setValue('01:00:00');  //Internal Time Zone, UTC
    gs.info("time is "+ gt.getByFormat('hh:mm:ss'));

## GlideTime - 빼기(GlideTime startTime, GlideTime endTime) {#ariaid-title17}

두 GlideTime 객체 값 간의 기간 차이를 가져옵니다.
{#r_ScopedGlideTimeSubtract_GlideTime_GlideTime__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| startTime | 글라이드 타임 | 시작 값입니다. |
| endTime | 글라이드 타임 | 종료 값입니다. |
[표 29. 매개변수]

{#r_ScopedGlideTimeSubtract_GlideTime_GlideTime__table_vy2_525_jq} {#r_ScopedGlideTimeSubtract_GlideTime_GlideTime__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| GlideDuration (글라이드 기간) | 두 값 사이의 기간입니다. |
[표 30. 반환]

{#r_ScopedGlideTimeSubtract_GlideTime_GlideTime__table_qpt_3f5_jq}  

    var gd1 = new GlideTime(); 
    gd1.setDisplayValue("09:00:00"); 
    var gd2 = new GlideTime(); 
    gd2.setDisplayValue("09:10:00"); 
     
    var dur = GlideDate.subtract(gd1, gd2); //the difference between gdt1 and gdt2 
    gs.info(dur.getDisplayValue());