---
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


---

# GlideDate - 범위 지정됨

# GlideDate - 범위 지정됨 {#ariaid-title1}

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

범위가 지정된 GlideDate 클래스는 GlideDate 객체 인스턴스화 또는 GlideDate 필드 작업 등 GlideDate 객체에 대한 작업을 수행하기 위한 메서드를 제공합니다.

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

## 범위 지정된 GlideDate - GlideDate() {#ariaid-title2}

현재 날짜 시간으로 GlideDate 객체를 작성합니다.
{#r_ScopedGlideDateGlideDate__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateGlideDate__table_vy2_525_jq}  

    //Today's date is April 21, 2021
    var gd = new GlideDate();
    gs.info(gd.getValue());

출력:

    2021-04-21

## 범위 지정된 GlideDate - getByFormat(문자열 형식) {#ariaid-title3}

지정된 날짜 형식의 날짜를 가져옵니다.
{#r_ScopedGlideDateGetByFormat_String__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| format | 문자열 | Java [SimpleDateFormat](https://docs.oracle.com/javase/10/docs/api/java/text/SimpleDateFormat.html)을 사용한 원하는 날짜 형식입니다. 예를 들어 일, 월, 연도를 가져오려면 `"dd-MM-yyyy"` , 요일을 가져오려면 `"EEEE"` 를 사용합니다. |
[표 2. 매개변수]

{#r_ScopedGlideDateGetByFormat_String__table_vy2_525_jq} {#r_ScopedGlideDateGetByFormat_String__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 지정된 형식의 GlideDate 객체에 대한 날짜 값입니다. |
[표 3. 반환]

{#r_ScopedGlideDateGetByFormat_String__table_qpt_3f5_jq}  

    var gd = new GlideDate(); 
    gd.setValue('2021-04-21');
    gs.info(gd.getByFormat("dd-MM-yyyy"));

출력:

    21-04-2021

## 범위 지정 GlideDate - getDayOfMonthNoTZ() {#ariaid-title4}

GlideDate 개체에 의해 저장된 월의 일을 UTC 표준 시간대로 가져옵니다.
{#r_SGD-getDayOfMonthNoTZ__table_gdd_z5q_yv__entry__3}

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

{#r_SGD-getDayOfMonthNoTZ__table_gdd_z5q_yv} {#r_SGD-getDayOfMonthNoTZ__table_hdd_z5q_yv__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | UTC 시간대의 날짜(1에서 31까지)입니다. |
[표 5. 반환]

{#r_SGD-getDayOfMonthNoTZ__table_hdd_z5q_yv}  

    //Today's date is 2016-05-13 
    var gd =new GlideDate();
    gs.info(gd.getDayOfMonthNoTZ());

출력:

    13

## 범위 지정된 GlideDate - getDisplayValue() {#ariaid-title5}

현재 사용자의 표시 형식 및 시간대의 날짜를 가져옵니다.
{#r_ScopedGlideDateGetDisplayValue__table_vy2_535_jq__entry__3}

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

{#r_ScopedGlideDateGetDisplayValue__table_vy2_535_jq} {#r_ScopedGlideDateGetDisplayValue__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 현재 사용자의 표시 형식 및 시간대로 나타낸 GlideDate 객체의 날짜 값입니다. 비즈니스 규칙 또는 스크립트 포함을 디자인할 때는 이 메서드가 사용자마다 다른 형식으로 값을 반환할 수 있다는 점에 유의하십시오. |
[표 7. 반환]

{#r_ScopedGlideDateGetDisplayValue__table_qpt_3f5_jq}  

    var gd = new GlideDate(); 
    gd.setValue('2021-04-21');
    gs.info(gd.getDisplayValue());

출력:

    2021-04-21

## 범위 지정된 GlideDate - getDisplayValueInternal() {#ariaid-title6}

내부 형식(yyyy-MM-dd)의 날짜와 현재 사용자의 시간대를 가져옵니다.
{#r_ScopedGlideDateGetDisplayValueInternal__table_vy2_535_jq__entry__3}

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

{#r_ScopedGlideDateGetDisplayValueInternal__table_vy2_535_jq} {#r_ScopedGlideDateGetDisplayValueInternal__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 현재 사용자의 시간대에 있는 GlideDate 객체의 날짜 값입니다. 형식: yyyy-MM-dd |
[표 9. 반환]

{#r_ScopedGlideDateGetDisplayValueInternal__table_qpt_3f5_jq}  

    var gd = new GlideDate(); 
    gs.info(gd.getDisplayValueInternal());

출력:

    2021-04-21

## 범위 지정된 GlideDate - getDisplayValueLang(문자열 스타일, 문자열 언어) {#ariaid-title7}

지정된 언어와 날짜 스타일에 따라 사용자의 로캘에서 날짜 값을 반환합니다.
{#r_SGD-getDisplayValueLang_S_S__id_a2q_p5w_dwb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 스타일 | 문자열 | 날짜 형식입니다. 유효한 값은 다음과 같습니다. * full: 사용자의 로캘에 따라 \<요일, 월, 일, 연도\> 형식으로 날짜를 반환합니다(예: 2022년 10월 24일 월요일). * long: 사용자의 로캘에 따라 \<월, 일, 연도\> 형식으로 날짜를 반환합니다(예: 2022년 10월 24일). * medium: long 과 유사하지만 축약된 월이 있는 날짜를 반환합니다(예: Oct 24, 2022). * short: 사용자의 로캘에 따라 MM/DD/YY 또는 DD/MM/YY 형식으로 날짜를 반환합니다(예: 2022/10/24 또는 2022/10/24). 다른 값이 전달되면 API의 기본값은 `중간`입니다. 허용되는 값은 대소문자를 구분하지 않습니다. |
| 언어 | 문자열 | 지정된 언어 값에 따라 날짜를 반환합니다. BCP-47 표준을 준수하는 언어 태그를 허용합니다. 예를 들어 프랑스어의 경우 `fr` , 영국 영어의 경우 `en-UK` 입니다. 허용되는 값의 전체 목록은 [BCP 47 언어 코드 목록을](https://appmakers.dev/bcp-47-language-codes-list/) 참조하세요. |
[표 10. 매개변수]

{#r_SGD-getDisplayValueLang_S_S__id_a2q_p5w_dwb} {#r_SGD-getDisplayValueLang_S_S__id_wwn_q5w_dwb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 현재 사용자의 로캘에 따라 지정된 스타일과 언어의 날짜입니다. |
[표 11. 반환]

{#r_SGD-getDisplayValueLang_S_S__id_wwn_q5w_dwb}  
다음 예제에서는 다양한 언어와 스타일로 사용자 로캘의 날짜를 반환합니다.

    var gd = new GlideDate(); // This will fetch the current date


    gs.info('date: ' + gd.getDisplayValue());

    gs.info('date: ' + gd.getDisplayValueLang("full", "fr"));
    gs.info('date: ' + gd.getDisplayValueLang("long", "en-GB"));
    gs.info('date: ' + gd.getDisplayValueLang("medium", "de"));
    gs.info('date: ' + gd.getDisplayValueLang("short", "es-MX"));

출력:


    date: 2023-01-18
    date: mercredi 18 janvier 2023
    date: 18 January 2023
    date: 18.01.2023
    date: 18/01/23

## 범위 지정 GlideDate - getMonthNoTZ() {#ariaid-title8}

GlideDate 개체에 의해 저장된 월을 UTC 표준 시간대로 가져옵니다.
{#r_SGD-getMonthNoTZ__table_az1_3wq_yv__entry__3}

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

{#r_SGD-getMonthNoTZ__table_az1_3wq_yv} {#r_SGD-getMonthNoTZ__table_bz1_3wq_yv__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | 1에서 12까지의 월별 숫자 값입니다. |
[표 13. 반환]

{#r_SGD-getMonthNoTZ__table_bz1_3wq_yv}  

    //Today's date is 2016-05-13
    var gd =new GlideDate();
    gs.info(gd.getMonthNoTZ());

출력:

    5

## 범위 지정된 GlideDate - getValue() {#ariaid-title9}

내부 형식(yyyy-MM-dd)과 시스템 표준 시간대(기본적으로 UTC)의 날짜를 가져옵니다.
{#r_ScopedGlideDateGetValue__table_vy2_535_jq__entry__3}

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

{#r_ScopedGlideDateGetValue__table_vy2_535_jq} {#r_ScopedGlideDateGetValue__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 시스템 시간대에 있는 GlideDate 객체의 날짜 값입니다. 형식: yyyy-MM-dd |
[표 15. 반환]

{#r_ScopedGlideDateGetValue__table_qpt_3f5_jq}  

    var gd = new GlideDate();
    gd.setValue('2021-04-21');
    gs.info(gd.getValue());

출력:

    2021-04-21

## 범위 지정 GlideDate - getYearNoTZ() {#ariaid-title10}

GlideDate 개체에 의해 저장된 연도를 UTC 표준 시간대로 가져옵니다.
{#r_SGD-getYearNoTZ__table_pnp_hxq_yv__entry__3}

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

{#r_SGD-getYearNoTZ__table_pnp_hxq_yv} {#r_SGD-getYearNoTZ__table_qnp_hxq_yv__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | 연도의 숫자 값입니다. |
[표 17. 반환]

{#r_SGD-getYearNoTZ__table_qnp_hxq_yv}  

    //Today's date is 2016-05-13
    var gd =new GlideDate();
    gs.info(gd.getYearNoTZ());

출력:

    2016

## 범위 지정된 GlideDate - setDisplayValue(표시된 문자열) {#ariaid-title11}

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

| 이름 | 유형 | 설명 |
|-|-|-|
| asDisplayed로 | 문자열 | 현재 사용자의 표시 형식 및 시간대의 날짜입니다. 형식: 현재 사용자가 선호하는 표시 형식(예: yyyy-MM-dd)을 사용하여 형식을 지정해야 합니다. |
[표 18. 매개변수]

{#r_ScopedGlideDateSetDisplayValue_String__table_vy2_525_jq} {#r_ScopedGlideDateSetDisplayValue_String__table_qpt_3f5_jq1__entry__2}

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

{#r_ScopedGlideDateSetDisplayValue_String__table_qpt_3f5_jq1}  

    var gd = new GlideDate();
    gd.setDisplayValue("2011-01-01");
    gs.info(gd.getValue());

출력:

    2011-01-01

## 범위 지정된 GlideDate - setDisplayValueLang(문자열 날짜, 문자열 스타일) {#ariaid-title12}

현재 사용자의 로캘에 따라 지정된 스타일과 형식을 사용하여 날짜를 설정합니다.
{#r_SGD-setDisplayValueLang_S_S__id_m14_55w_dwb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 날짜 | 문자열 | 현재 사용자의 시간대에 있는 GlideDate 객체의 날짜 값입니다. 유효한 값은 getDisplayValueLang() 함수에서 출력된 날짜 및 시간입니다. 예를 들어 이 항목의 앞부분에 있는 getDisplayValueLang(String style, String language) 예제의 출력을 사용하면 2022년 10월 25일 또는 2022년 10월 25 일이 허용되는 값입니다. |
| 스타일 | 문자열 | 날짜 형식입니다. 유효한 값은 다음과 같습니다. * full: 사용자의 로캘에 따라 \<요일, 월, 일, 연도\> 형식으로 날짜를 반환합니다(예: 2022년 10월 24일 월요일). * long: 사용자의 로캘에 따라 \<월, 일, 연도\> 형식으로 날짜를 반환합니다(예: 2022년 10월 24일). * medium: long 과 유사하지만 축약된 월이 있는 날짜를 반환합니다(예: Oct 24, 2022). * short: 사용자의 로캘에 따라 MM/DD/YY 또는 DD/MM/YY 형식으로 날짜를 반환합니다(예: 2022/10/24 또는 2022/10/24). 다른 값이 전달되면 API의 기본값은 `중간`입니다. 허용되는 값은 대소문자를 구분하지 않습니다. |
[표 20. 매개변수]

{#r_SGD-setDisplayValueLang_S_S__id_m14_55w_dwb} {#r_SGD-setDisplayValueLang_S_S__id_xh1_v5w_dwb__entry__2}

| 유형 | 설명 |
|-|-|
| void |   |
[표 21. 반환]

{#r_SGD-setDisplayValueLang_S_S__id_xh1_v5w_dwb}  
다음 예제에서는 setDisplayValueLang()을 사용하여 사용자 로캘의 현재 날짜를 'full' 스타일로 설정하는 방법을 보여 줍니다.

    glideDate.setDisplayValueLang("2/3/2023", "short");


    gs.info('date: ' + glideDate.getDisplayValue());
    gs.info('date: ' + glideDate.getDisplayValueLang("full"));

출력:

    date: 2023-02-03
    date: Friday, February 3, 2023

## 범위 지정된 GlideDate - setDisplayValueLang(문자열 날짜, 문자열 스타일, 문자열 언어) {#ariaid-title13}

현재 사용자의 로캘에 따라 지정된 스타일, 언어 및 형식을 사용하여 날짜를 설정합니다.
{#r_SGD-setDisplayValueLang_S_S_S__id_kns_w5w_dwb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 날짜 | 문자열 | 현재 사용자의 시간대에 있는 GlideDate 객체의 날짜 값입니다. 유효한 값은 getDisplayValueLang() 함수에서 출력된 날짜 및 시간입니다. 예를 들어 이 항목의 앞부분에 있는 getDisplayValueLang(String style, String language) 예제의 출력을 사용하면 2022년 10월 25일 또는 2022년 10월 25 일이 허용되는 값입니다. |
| 스타일 | 문자열 | 날짜 형식입니다. 유효한 값은 다음과 같습니다. * full: 사용자의 로캘에 따라 \<요일, 월, 일, 연도\> 형식으로 날짜를 반환합니다(예: 2022년 10월 24일 월요일). * long: 사용자의 로캘에 따라 \<월, 일, 연도\> 형식으로 날짜를 반환합니다(예: 2022년 10월 24일). * medium: long 과 유사하지만 축약된 월이 있는 날짜를 반환합니다(예: Oct 24, 2022). * short: 사용자의 로캘에 따라 MM/DD/YY 또는 DD/MM/YY 형식으로 날짜를 반환합니다(예: 2022/10/24 또는 2022/10/24). 다른 값이 전달되면 API의 기본값은 `중간`입니다. 허용되는 값은 대소문자를 구분하지 않습니다. |
| 언어 | 문자열 | BCP-47 표준을 준수하는 언어 태그를 사용하여 언어를 설정합니다. 예를 들어 프랑스어의 경우 `fr` , 영국 영어의 경우 `en-UK` 입니다. 허용되는 값의 전체 목록은 [BCP 47 언어 코드 목록을](https://appmakers.dev/bcp-47-language-codes-list/) 참조하세요. |
[표 22. 매개변수]

{#r_SGD-setDisplayValueLang_S_S_S__id_kns_w5w_dwb} {#r_SGD-setDisplayValueLang_S_S_S__id_j5m_x5w_dwb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 23. 반환]

{#r_SGD-setDisplayValueLang_S_S_S__id_j5m_x5w_dwb}  
다음 예제에서는 날짜 및 시간을 영어와 프랑스어에 대한 짧은 스타일과 전체 스타일로 반환합니다.

    var glideDateFR = new GlideDate(); 

    glideDateUS.setDisplayValueLang("2/3/202", "short", "en-US" );
    glideDateFR.setDisplayValueLang("2/3/2023", "short", "fr-FR" );

    gs.info('en-US date: ' + glideDateUS.getDisplayValue());
    gs.info('en-US date: ' + glideDateUS.getDisplayValueLang("full"));

    gs.info('fr-FR date: ' + glideDateFR.getDisplayValue());
    gs.info('fr-FR date: ' + glideDateFR.getDisplayValueLang("full"));

출력:

    en-US date: 2023-02-03
    en-US date: Friday, February 3, 2023
    fr-FR date: 2023-03-02
    fr-FR date: Thursday, March 2, 2023

## 범위 지정된 GlideDate - setValue(문자열 o) {#ariaid-title14}

현재 GlideDate 객체의 날짜를 내부 형식(yyyy-MM-dd)과 시스템 시간대(기본적으로 UTC)로 설정합니다.
{#r_ScopedGlideDateSetValue_String__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| o | 문자열 | 현재 GlideDate 객체에서 설정할 날짜 및 시간입니다. 형식: yyyy-MM-dd |
[표 24. 매개변수]

{#r_ScopedGlideDateSetValue_String__table_vy2_525_jq} {#r_ScopedGlideDateSetValue_String__table_qpt_3f5_jq1__entry__2}

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

{#r_ScopedGlideDateSetValue_String__table_qpt_3f5_jq1}  

    var gd = new GlideDate(); 
    gd.setValue('2015-01-01');
    gs.info(gd.getValue());

출력:

    2015-01-01

## 범위 지정된 GlideDate - 빼기(GlideDate 시작, GlideDate 종료) {#ariaid-title15}

두 GlideDate 값 간의 기간 차이를 가져옵니다.
{#r_ScopedGlideDateSubtract_GlideDate_GlideDate__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 시작 | GlideDate | 시작 값입니다. |
| 끝 | GlideDate | 종료 값입니다. |
[표 26. 매개변수]

{#r_ScopedGlideDateSubtract_GlideDate_GlideDate__table_vy2_525_jq} {#r_ScopedGlideDateSubtract_GlideDate_GlideDate__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateSubtract_GlideDate_GlideDate__table_qpt_3f5_jq}  

    var sgd1 = new GlideDate(); 
    sgd1.setDisplayValue('2014-07-18'); 
    var sgd2 = new GlideDate(); 
    sgd2.setDisplayValue('2014-07-19'); 
     
    var duration = GlideDate.subtract(sgd1, sgd2); 
    gs.info(duration.getDisplayValue());

출력:

    1 Day