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


---

# GlideDateTime - 전역

# GlideDateTime - 전역 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 65분

GlideDateTime 클래스는 GlideDateTime 객체에 대한 작업을 수행하기 위한 메서드를 제공합니다.

GlideDateTime 메서드를 사용하여 GlideDateTime 객체 인스턴스화, 날짜-시간 계산 수행, 날짜-시간 서식 지정 또는 날짜-시간 형식 간 변환과 같은 날짜-시간 작업을 수행합니다.

## glide_date_time 필드 수정

GlideDateTime 메서드에서 형식 glide_date_time의 데이터베이스 열로 작업하는 경우 날짜 및 시간 계산을 수행하기 전에 먼저 필드 값을 `GlideDateTime` 객체로 변환해야 합니다. `glide_date_time` 필드는 GlideElement로 표시됩니다. Glide 요소 호출 - getGlideObject()는`addMonthsUTC()`와 같은 날짜 조작 메서드를 지원하는 `GlideDateTime` 객체를 반환합니다. 자세한 내용은 [GlideElement - getGlideObject()](https://servicenow-prod.fluidtopics.net/ICFl70X4_lFd8eJ7ry_BWg#r_GlideElement-getGlideObject "필드 값과 연결된 플랫폼 객체를 검색합니다.") 문서를 참조하십시오.

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

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

현재 날짜 및 시간을 사용하여 새 GlideDateTime 객체를 인스턴스화합니다.
{#r_GDT-GlideDateTime__table_qpq_slc_nt__entry__3}

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

{#r_GDT-GlideDateTime__table_qpq_slc_nt}  
이 예시에서는 GlideDateTime 객체를 인스턴스화합니다.

    var gdt = new GlideDateTime();
    gs.info(gdt);

출력:

    2022-08-08 16:51:44

## GlideDateTime - GlideDateTime(문자열 dateTime) {#ariaid-title3}

전달된 날짜 및 시간 값을 사용하여 새 GlideDateTime 객체를 인스턴스화합니다.
시스템은 전달된 값을 지정된 내부 시스템 형식과 일치시키려고 시도합니다. 인수가 시스템 형식과 일치하지 않으면 시스템은 다음 순서대로 다음 형식 중 하나와 일치시키려고 시도합니다.

* yyyy-MM-dd HH:mm:ss
* MM/dd/yyyy HH:mm:ss
* MM-dd-yyyy HH:mm:ss
* MM-dd-yyyy HH:mm
* MM-dd-yyyy
* MM/dd/yyyy
* dd-MM-yyyy HH:mm:ss
* dd-MM-yyyy HH.mm.ss
* dd-MM-yyyy HH.mm
* dd-MM-yy HH.mm.ss
* dd/MM/yyyy
* dd-MM-yyyy
* yyyy-MM-dd HH:mm
* yyyy-MM-dd
* dd.MM.yyyy HH:mm:ss
* dd.MM.yyyy HH.mm.ss
* dd.MM.yyyy hh:mm:ss a
* dd.MM.yyyy hh.mm.ss
* dd.MM.yyyy

{#r_GDT-GlideDateTime_S__ul_xgq_hmz_lnb}  
주:  
다음 형식은 지원되지 않습니다.

* yyyy-MM-dd'T'HH:mm:ss. SSSZ
{#r_GDT-GlideDateTime_S__ul_udg_d5w_lcc}
{#r_GDT-GlideDateTime_S__table_ufk_jmc_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 날짜/시간 | 문자열 | GlideDateTime 객체에서 설정할 UTC 날짜 및 시간입니다. |
[표 2. 매개변수]

{#r_GDT-GlideDateTime_S__table_ufk_jmc_nt}  
이 예시에서는 문자열을 사용하여 GlideDateTime 객체를 인스턴스화하는 방법을 보여줍니다.

    var gdt = new GlideDateTime("2023-01-01 12:00:00");
    gs.info(gdt);

출력:

    2023-01-01 12:00:00

## GlideDateTime - GlideDateTime(GlideDateTime gdt) {#ariaid-title4}

지정된 GlideDateTime 객체의 시간으로 설정된 새 GlideDateTime 객체를 인스턴스화합니다.
{#r_GDT-GlideDateTime_GDT__table_jqw_cnc_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| gdt | GlideDateTime | 새 객체의 시간을 설정하는 데 사용되는 객체입니다. |
[표 3. 매개변수]

{#r_GDT-GlideDateTime_GDT__table_jqw_cnc_nt}  
이 예제에서는 `yyyy-MM-dd HH:mm:ss` 형식의 문자열을 사용하여 GlideDateTime 객체(gdt1)를 인스턴스화하고 gdt1을 사용하여 두 번째 GlideDateTime 객체(gdt2)를 인스턴스화하는 방법을 보여줍니다.

    var gdt1 = new GlideDateTime("2025-01-28 12:00:00"); // GlideDateTime(String g)
    var gdt2 = new GlideDateTime(gdt1); // GlideDateTime(GlideDateTime g)
    gs.info(gdt1);
    gs.info(gdt2);

출력:

    2025-01-28 12:00:00
    2025-01-28 12:00:00

## GlideDateTime - add(숫자 밀리초) {#ariaid-title5}

GlideDateTime 객체에 지정된 시간(밀리초)을 추가합니다.
{#r_GDT-add_N__table_x2g_nsl_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 밀리초 | 번호 | 추가할 시간(밀리초) |
[표 4. 매개변수]

{#r_GDT-add_N__table_x2g_nsl_nt} {#r_GDT-add_N__table_y2g_nsl_nt__entry__2}

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

{#r_GDT-add_N__table_y2g_nsl_nt}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gs.print(gdt.getNumericValue());
    gdt.add(10);
    gs.print(gdt.getNumericValue());

출력:

    1314777600000
    1314777600010

### 범위가 지정된 해당 항목 {#r_GDT-add_N__section_bqp_jnr_mcb}

범위가 지정된 애플리케이션에서 add() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [add()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeAdd_Number "현재 GlideDateTime 객체에 지정된 시간(밀리초)을 추가합니다.")를 사용합니다.

## GlideDateTime - add(GlideTime 시간) {#ariaid-title6}

현재 GlideDateTime 객체에 GlideTime 객체를 추가합니다.
{#r_GDT-add_GT__table_e4r_xs2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 시간 | [글라이드타임](https://servicenow-prod.fluidtopics.net/3v919zdTb~FQT4lnsjrdIg#c_GlideTimeScopedAPI "GlideTime API에는 GlideTime 객체 인스턴스화 또는 GlideTime 필드 작업과 같은 GlideTime 객체에 대한 작업을 수행하는 메서드가 있습니다.") | 지정된 GlideDateTime 객체에 추가할 시간 값의 GlideTime 객체입니다. |
[표 6. 매개변수]

{#r_GDT-add_GT__table_e4r_xs2_nt} {#r_GDT-add_GT__table_f4r_xs2_nt__entry__2}

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

{#r_GDT-add_GT__table_f4r_xs2_nt}  
이 예시에서는 gdt GlideDateTime 객체에 설정된 시간에 20초를 추가하는 방법을 보여줍니다.

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    var gtime1 = new GlideTime();
    gtime1.setValue("00:00:20");
    gdt.add(gtime1);
    gs.print(gdt.toString());

출력:

    2011-08-31 08:00:20

### 범위가 지정된 해당 항목 {#r_GDT-add_GT__section_prv_gnr_mcb}

범위가 지정된 애플리케이션에서 add() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [add()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeAdd_GlideTime_gd "현재 GlideDateTime 객체에 GlideTime 객체를 추가합니다.")를 사용합니다.

## GlideDateTime - addDays(일 수) {#ariaid-title7}

현재 GlideDateTime 객체에 지정된 일수를 추가합니다. 음수 매개변수는 일을 뺍니다.
범위가 지정된 애플리케이션에서는 이 방법을 사용할 수 없습니다. 범위가 지정된 애플리케이션에서 addDaysLocalTime() 또는 addDaysUTC() 를 사용할 수도 있습니다.
{#r_GDT-addDays_N__table_h1q_3t2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 일 | 번호 | 추가할 일 수입니다. 음수를 사용하여 뺍니다. |
[표 8. 매개변수]

{#r_GDT-addDays_N__table_h1q_3t2_nt} {#r_GDT-addDays_N__table_i1q_3t2_nt__entry__2}

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

{#r_GDT-addDays_N__table_i1q_3t2_nt}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gdt.addDays(-1);
    gs.print(gdt.getDate());

출력:

    2011-08-30

## GlideDateTime - addDaysLocalTime(일 수) {#ariaid-title8}

현재 GlideDateTime 객체에 지정된 일수를 추가합니다. 음수 매개변수는 일을 뺍니다.
이 메서드는 GlideDateTime 객체에 의해 저장된 값에 해당하는 로컬 날짜 및 시간을 결정한 다음 로컬 날짜 및 시간 값을 사용하여 일을 더하거나 뺍니다.
{#r_GDT-addDaysLocalTime_N__table_ll1_xt2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 일 | 번호 | 추가할 일 수입니다. 음수 값을 사용하여 뺍니다. |
[표 10. 매개변수]

{#r_GDT-addDaysLocalTime_N__table_ll1_xt2_nt} {#r_GDT-addDaysLocalTime_N__table_ml1_xt2_nt__entry__2}

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

{#r_GDT-addDaysLocalTime_N__table_ml1_xt2_nt}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gdt.addDaysLocalTime(-1);
    gs.print(gdt.getLocalDate());

출력:

    2011-08-30

### 범위가 지정된 해당 항목 {#r_GDT-addDaysLocalTime_N__section_hnw_5lr_mcb}

범위가 지정된 애플리케이션에서 addDaysLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [addDaysLocalTime()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeAddDaysLocalTime_Number "현재 GlideDateTime 객체에 지정된 일수를 추가합니다. 음수 매개변수는 일을 뺍니다. 이 메서드는 GlideDateTime 객체에 의해 저장된 값에 해당하는 로컬 날짜 및 시간을 결정한 다음 로컬 날짜 및 시간 값을 사용하여 일을 더하거나 뺍니다.")을 사용합니다.

## GlideDateTime - addDaysUTC(일 수) {#ariaid-title9}

현재 GlideDateTime 객체에 지정된 일수를 추가합니다. 음수 매개변수는 일을 뺍니다.
이 메서드는 GlideDateTime 개체에 저장된 값과 동일한 UTC 날짜 및 시간을 결정한 다음 UTC 날짜 및 시간 값을 사용하여 일을 더하거나 뺍니다.
{#r_GDT-addDaysUTC_N__table_vyt_k52_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 일 | 번호 | 추가할 일 수입니다. 음수 값을 사용하여 뺍니다. |
[표 12. 매개변수]

{#r_GDT-addDaysUTC_N__table_vyt_k52_nt} {#r_GDT-addDaysUTC_N__table_wyt_k52_nt__entry__2}

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

{#r_GDT-addDaysUTC_N__table_wyt_k52_nt}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gdt.addDaysUTC(-1);
    gs.print(gdt.getDate());

출력:

    2011-08-30

### 범위가 지정된 해당 항목 {#r_GDT-addDaysUTC_N__section_ljh_ylr_mcb}

범위가 지정된 애플리케이션에서 addDaysUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [addDaysUTC()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeAddDaysUTC_Number "현재 GlideDateTime 객체에 지정된 일수를 추가합니다. 음수 매개변수는 일을 뺍니다. 이 메서드는 GlideDateTime 개체에 저장된 값과 동일한 UTC 날짜 및 시간을 결정한 다음 UTC 날짜 및 시간 값을 사용하여 일을 더하거나 뺍니다.")를 사용합니다.

## GlideDateTime - addSeconds(숫자 초) {#ariaid-title10}

GlideDateTime 객체에 지정된 시간(초)을 추가합니다.
{#r_GDT-addSeconds_N__table_xlx_zsl_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 초 | 번호 | 추가할 시간(초) |
[표 14. 매개변수]

{#r_GDT-addSeconds_N__table_xlx_zsl_nt} {#r_GDT-addSeconds_N__table_ylx_zsl_nt__entry__2}

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

{#r_GDT-addSeconds_N__table_ylx_zsl_nt}  

    var gdt = new GlideDateTime("2011-12-07 08:00:00");
    gdt.addSeconds(1000);
    gs.print(gdt.getValue());

출력:

    2011-12-07 08:16:40

### 범위가 지정된 해당 항목 {#r_GDT-addSeconds_N__section_mnz_gmr_mcb}

범위가 지정된 애플리케이션에서 addSeconds() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [addSeconds()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeAddSeconds_Number "현재 GlideDateTime 객체에 지정된 시간(초)을 추가합니다.")를 사용합니다.

## GlideDateTime - addWeeks(주 수) {#ariaid-title11}

현재 GlideDateTime 객체에 지정된 주 수를 추가합니다. 음수 매개변수는 주를 뺍니다.
이 메서드 대신 addWeeksLocalTime() 및 addWeeksUTC() 를 사용합니다.
{#r_GDT-addWeeks_N__table_bpk_v52_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 주 | 번호 | 추가할 주 수입니다. 음수를 사용하여 뺍니다. |
[표 16. 매개변수]

{#r_GDT-addWeeks_N__table_bpk_v52_nt} {#r_GDT-addWeeks_N__table_cpk_v52_nt__entry__2}

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

{#r_GDT-addWeeks_N__table_cpk_v52_nt}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gdt.addWeeks(-1);
    gs.print(gdt.getDate());

출력:

    2011-08-24

## GlideDateTime - addWeeksLocalTime(주 수) {#ariaid-title12}

현재 GlideDateTime 객체에 지정된 주 수를 추가합니다. 음수 매개변수는 주를 뺍니다.
이 메서드는 GlideDateTime 개체에 의해 저장된 값에 해당하는 로컬 날짜 및 시간을 결정한 다음 로컬 날짜 및 시간 값을 사용하여 주를 더하거나 뺍니다.
{#r_GDT-addWeeksLocalTime_N__table_ozv_3v2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 주 | 번호 | 추가할 주 수입니다. 음수를 사용하여 뺍니다. |
[표 18. 매개변수]

{#r_GDT-addWeeksLocalTime_N__table_ozv_3v2_nt} {#r_GDT-addWeeksLocalTime_N__table_pzv_3v2_nt__entry__2}

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

{#r_GDT-addWeeksLocalTime_N__table_pzv_3v2_nt}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gdt.addWeeksLocalTime(-1);
    gs.print(gdt.getDate());

출력:

    2011-08-24

### 범위가 지정된 해당 항목 {#r_GDT-addWeeksLocalTime_N__section_uq1_wmr_mcb}

범위가 지정된 애플리케이션에서 addWeeksLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [addWeeksLocalTime()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeAddWeeksLocalTime_Number "현재 GlideDateTime 객체에 지정된 주 수를 추가합니다. 음수 매개변수는 주를 뺍니다. 이 메서드는 GlideDateTime 개체에 의해 저장된 값에 해당하는 로컬 날짜 및 시간을 결정한 다음 로컬 날짜 및 시간 값을 사용하여 주를 더하거나 뺍니다.")을 사용합니다.

## GlideDateTime - addWeeksUTC(주 수) {#ariaid-title13}

현재 GlideDateTime 객체에 지정된 주 수를 추가합니다. 음수 매개변수는 주를 뺍니다.
이 메서드는 GlideDateTime 개체에 저장된 값과 동등한 UTC 날짜 및 시간을 결정한 다음 UTC 날짜 및 시간 값을 사용하여 주를 더하거나 뺍니다.
{#r_GDT-addWeeksUTC_N__table_rdr_5v2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 주 | 번호 | 추가할 주 수입니다. 음수를 사용하여 뺍니다. |
[표 20. 매개변수]

{#r_GDT-addWeeksUTC_N__table_rdr_5v2_nt} {#r_GDT-addWeeksUTC_N__table_sdr_5v2_nt__entry__2}

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

{#r_GDT-addWeeksUTC_N__table_sdr_5v2_nt}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gdt.addWeeksUTC(-1);
    gs.print(gdt.getDate());

출력:

    2011-08-24

### 범위가 지정된 해당 항목 {#r_GDT-addWeeksUTC_N__section_pnm_ymr_mcb}

범위가 지정된 애플리케이션에서 addWeeksUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [addWeeksUTC()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeAddWeeksUTC_Number "현재 GlideDateTime 객체에 지정된 주 수를 추가합니다. 음수 매개변수는 주를 뺍니다. 이 메서드는 GlideDateTime 개체에 저장된 값과 동등한 UTC 날짜 및 시간을 결정한 다음 UTC 날짜 및 시간 값을 사용하여 주를 더하거나 뺍니다.")를 사용합니다.

## GlideDateTime - addMonths(월 수) {#ariaid-title14}

현재 GlideDateTime 객체에 지정된 개월 수를 추가합니다. 음수 매개변수는 월을 뺍니다.
이 메서드 대신 addMonthsLocalTime() 또는 addMonthsUTC() 를 사용합니다.
{#r_GDT-addMonths_N__table_tgm_bkk_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 월 | 번호 | 추가할 개월 수입니다. 음수를 사용하여 뺍니다. |
[표 22. 매개변수]

{#r_GDT-addMonths_N__table_tgm_bkk_nt} {#r_GDT-addMonths_N__table_ugm_bkk_nt__entry__2}

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

{#r_GDT-addMonths_N__table_ugm_bkk_nt}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gdt.addMonths(2);
    gs.print(gdt.getDate());

출력:

    2011-10-31

## GlideDateTime - addMonthsLocalTime(월 수) {#ariaid-title15}

현재 GlideDateTime 객체에 지정된 개월 수를 추가합니다. 음수 매개변수는 월을 뺍니다.
이 메서드는 GlideDateTime 객체에 저장된 값에 해당하는 로컬 날짜 및 시간을 결정한 다음 로컬 날짜 및 시간 값을 사용하여 월을 더하거나 뺍니다.
{#r_GDT-addMonthsLocalTime_N__table_fmn_pkk_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 월 | 번호 | 추가할 개월 수입니다. 음수 값을 사용하여 뺍니다. |
[표 24. 매개변수]

{#r_GDT-addMonthsLocalTime_N__table_fmn_pkk_nt} {#r_GDT-addMonthsLocalTime_N__table_gmn_pkk_nt__entry__2}

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

{#r_GDT-addMonthsLocalTime_N__table_gmn_pkk_nt}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gdt.addMonthsLocalTime(2);
    gs.print(gdt.getDate());

출력:

    2011-10-31

### 범위가 지정된 해당 항목 {#r_GDT-addMonthsLocalTime_N__section_xvc_bmr_mcb}

범위가 지정된 애플리케이션에서 addMonthsLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [addMonthsLocalTime()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeAddMonthsLocalTime_Number "현재 GlideDateTime 객체에 지정된 개월 수를 추가합니다. 음수 매개변수는 월을 뺍니다. 이 메서드는 GlideDateTime 객체에 저장된 값에 해당하는 로컬 날짜 및 시간을 결정한 다음 로컬 날짜 및 시간 값을 사용하여 월을 더하거나 뺍니다.")을 사용합니다.

## GlideDateTime - addMonthsUTC(월 수) {#ariaid-title16}

현재 GlideDateTime 객체에 지정된 개월 수를 추가합니다. 음수 매개변수는 월을 뺍니다.
이 메서드는 GlideDateTime 객체에 저장된 값에 해당하는 UTC 날짜 및 시간을 결정한 다음 UTC 날짜 및 시간 값을 사용하여 월을 더하거나 뺍니다.

glide_date_time 유형의 데이터베이스 열로 작업하는 경우 날짜 및 시간 계산을 수행하기 전에 먼저 필드 값을 `GlideDateTime` 객체로 변환해야 합니다. `glide_date_time` 필드는 GlideElement로 표시됩니다. Glide 요소 - getGlideObject()를 호출하면 날짜 조작 메서드를 지원하는 `GlideDateTime` 객체가 반환됩니다. 자세한 내용은 [GlideElement - getGlideObject()](https://servicenow-prod.fluidtopics.net/ICFl70X4_lFd8eJ7ry_BWg#r_GlideElement-getGlideObject "필드 값과 연결된 플랫폼 객체를 검색합니다.") 문서를 참조하십시오.
{#r_GDT-addMonthsUTC_N__table_lqp_1lk_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 월 | 번호 | 추가할 개월 수입니다. 음수를 사용하여 뺍니다. |
[표 26. 매개변수]

{#r_GDT-addMonthsUTC_N__table_lqp_1lk_nt} {#r_GDT-addMonthsUTC_N__table_mqp_1lk_nt__entry__2}

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

{#r_GDT-addMonthsUTC_N__table_mqp_1lk_nt}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gdt.addMonthsUTC(2);
    gs.print(gdt.getDate());

출력:

    2011-10-31

다음 예제에서는 기록에서 DateTime 필드를 읽고, UTC 시간을 사용하여 월을 추가하고, 업데이트된 값을 필드에 다시 기록하는 방법을 보여줍니다.

    // Add 3 months (UTC) to a glide_date_time field on the current record
    var monthsToAdd = 3;

    // Convert the glide_date_time field (GlideElement) to a GlideDateTime object
    var gdt = current.u_renewal_date.getGlideObject();

    // Add months using UTC time
    gdt.addMonthsUTC(monthsToAdd);

    // Store the updated value back to the field using the internal (UTC) format
    current.u_renewal_date.setValue(gdt.getValue());

### 범위가 지정된 해당 항목 {#r_GDT-addMonthsUTC_N__section_gxn_2mr_mcb}

범위가 지정된 애플리케이션에서 addMonthsUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [addMonthsUTC()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeAddMonthsUTC_Number "현재 GlideDateTime 객체에 지정된 개월 수를 추가합니다. 음수 매개변수는 월을 뺍니다. 이 메서드는 GlideDateTime 객체에 저장된 값에 해당하는 UTC 날짜 및 시간을 결정한 다음 UTC 날짜 및 시간 값을 사용하여 월을 더하거나 뺍니다.")를 사용합니다.

## GlideDateTime - addYears(년 수) {#ariaid-title17}

현재 GlideDateTime 객체에 지정된 연도를 추가합니다. 음수 매개변수는 연도를 뺍니다.
이 메서드 대신 addYearsLocalTime() 또는 addYearsUTC() 를 사용합니다.
{#r_GDT-addYears_N__table_fpz_mlk_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 년 | 번호 | 추가할 연수입니다. 음수 값을 사용하여 뺍니다. |
[표 28. 매개변수]

{#r_GDT-addYears_N__table_fpz_mlk_nt} {#r_GDT-addYears_N__table_gpz_mlk_nt__entry__2}

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

{#r_GDT-addYears_N__table_gpz_mlk_nt}  

    var gdt = new GlideDateTime("2010-08-31 08:00:00");
    gdt.addYears(1);
    gs.print(gdt.getDate());

출력:

    2011-08-31

## GlideDateTime - addYearsLocalTime(숫자 년) {#ariaid-title18}

현재 GlideDateTime 객체에 지정된 연도를 추가합니다. 음수 매개변수는 연도를 뺍니다.
이 메서드는 GlideDateTime 개체에 저장된 값에 해당하는 로컬 날짜 및 시간을 결정한 다음 로컬 날짜 및 시간 값을 사용하여 연도를 더하거나 뺍니다.
{#r_GDT-addYearsLocalTime_N__table_llj_ryk_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 년 | 번호 | 추가할 연수입니다. 빼려면 음수 값을 사용합니다. |
[표 30. 매개변수]

{#r_GDT-addYearsLocalTime_N__table_llj_ryk_nt} {#r_GDT-addYearsLocalTime_N__table_mlj_ryk_nt__entry__2}

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

{#r_GDT-addYearsLocalTime_N__table_mlj_ryk_nt}  

    var gdt = new GlideDateTime("2010-08-31 08:00:00");
    gdt.addYearsLocalTime(1);
    gs.print(gdt.getDate());

출력:

    2011-08-31

### 범위가 지정된 해당 항목 {#r_GDT-addYearsLocalTime_N__section_yhl_bnr_mcb}

범위가 지정된 애플리케이션에서 AddYearsLocalTime() 메서드를 사용하려면 해당 범위가 지정된 메서드인 [AddYearsLocalTime()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeAddYearsLocalTime_Number "현재 GlideDateTime 객체에 지정된 연도를 추가합니다. 음수 매개변수는 연도를 뺍니다. 이 메서드는 GlideDateTime 개체에 저장된 값에 해당하는 로컬 날짜 및 시간을 결정한 다음 로컬 날짜 및 시간 값을 사용하여 연도를 더하거나 뺍니다.")을 사용합니다.

## GlideDateTime - addYearsUTC(Number years) {#ariaid-title19}

현재 GlideDateTime 객체에 지정된 연도를 추가합니다. 음수 매개변수는 연도를 뺍니다.
GlideDateTime 객체에 의해 저장된 날짜 및 시간 값은 UTC 시간대에 있는 것으로 해석됩니다.
{#r_GDT-addYearsUTC_N__table_njl_czk_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 년 | 번호 | 추가할 연수입니다. 음수 값을 사용하여 뺍니다. |
[표 32. 매개변수]

{#r_GDT-addYearsUTC_N__table_njl_czk_nt} {#r_GDT-addYearsUTC_N__table_ojl_czk_nt__entry__2}

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

{#r_GDT-addYearsUTC_N__table_ojl_czk_nt}  

    var gdt = new GlideDateTime("2010-08-31 08:00:00");
    gdt.addYearsUTC(1);
    gs.print(gdt.getDate());

출력:

    2011-08-31

### 범위가 지정된 해당 항목 {#r_GDT-addYearsUTC_N__section_yj1_2nr_mcb}

범위가 지정된 애플리케이션에서 addYearsUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [addYearsUTC()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeAddYearsUTC_Number "현재 GlideDateTime 객체에 지정된 연도를 추가합니다. 음수 매개변수는 연도를 뺍니다. GlideDateTime 객체에 의해 저장된 날짜 및 시간 값은 UTC 시간대에 있는 것으로 해석됩니다.")를 사용합니다.

## GlideDateTime - compareTo(객체 dateTime) {#ariaid-title20}

두 날짜 및 시간 객체를 비교하여 하나가 다른 날짜 및 시간 객체보다 먼저 발생하는지 또는 동일한지 확인합니다.
{#r_GDT-compareTo_O__table_sc3_rbd_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 날짜/시간 | 객체 | GlideDateTime 객체의 날짜 시간 |
[표 34. 매개변수]

{#r_GDT-compareTo_O__table_sc3_rbd_nt} {#r_GDT-compareTo_O__table_tc3_rbd_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | * 0 = 날짜가 같음 * 1 = 객체의 날짜가 매개변수에 지정된 날짜 이후임 * -1 = 객체의 날짜가 매개변수에 지정된 날짜 이전입니다. {#r_GDT-compareTo_O__ul_tb3_mjg_sz} |
[표 35. 반환]

{#r_GDT-compareTo_O__table_tc3_rbd_nt}  

    var initDate = new GlideDateTime("2011-08-01 12:00:00");
    var compDate1 = new GlideDateTime("2011-08-01 12:00:00");
    var compDate2 = new GlideDateTime("2011-07-31 12:00:00");
    var compDate3 = new GlideDateTime("2011-08-04 16:00:00");
     
    gs.info(initDate.compareTo(compDate1)); // Equals (0)
    gs.info(initDate.compareTo(compDate2)); // initDate is after compDate2 (1)
    gs.info(initDate.compareTo(compDate3)); // initDate is before compDate3 (-1)

출력:

    0
    1
    -1

### 범위가 지정된 해당 항목 {#r_GDT-compareTo_O__section_opf_mnr_mcb}

범위가 지정된 애플리케이션에서 compareTo() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [compareTo()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeCompareTo_Object_o "두 날짜 및 시간 객체를 비교하여 두 날짜 및 시간 객체가 동일한지 또는 다른 객체의 이전 또는 이후에 발생하는지 확인합니다.")를 사용합니다.

## GlideDateTime - 같음(객체 GDT) {#ariaid-title21}

동일성을 위해 객체를 기존 값과 비교합니다.
{#r_GDT-equals_O__table_njf_vvl_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| GDT | 객체 | 비교할 객체입니다. GlideDateTIme 객체 또는 유효한 날짜 시간 문자열일 수 있습니다. |
[표 36. 매개변수]

{#r_GDT-equals_O__table_njf_vvl_nt} {#r_GDT-equals_O__table_ojf_vvl_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 같으면 예이고 그렇지 않으면 아니오입니다. |
[표 37. 반환]

{#r_GDT-equals_O__table_ojf_vvl_nt}  

    var gdt = new GlideDateTime("2011-08-31 00:00:00");
    gs.print(gdt.equals("2011-09-30 00:12:01"));

출력:

     false

### 범위가 지정된 해당 항목 {#r_GDT-equals_O__section_i3p_4nr_mcb}

범위가 지정된 애플리케이션에서 equals() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [equals()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeEquals_Object "날짜/시간을 기존 값과 비교하여 동일성을 확인합니다.")를 사용합니다.

## GlideDateTime - getDate() {#ariaid-title22}

GlideDateTime 객체에 의해 저장된 날짜를 반환합니다. yyyy-MM-dd 형식과 시스템 시간대(UTC)로 표현됩니다.
{#r_GDT-getDate__table_mjv_xq2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 38. 매개변수]

{#r_GDT-getDate__table_mjv_xq2_nt} {#r_GDT-getDate__table_njv_xq2_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 시스템 시간대의 날짜입니다. 형식: yyyy-MM-dd 및 시스템 시간대의 경우 기본적으로 UTC입니다. |
[표 39. 반환]

{#r_GDT-getDate__table_njv_xq2_nt}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gs.info(gdt.getDate());

출력:

    2011-08-31

### 범위가 지정된 해당 항목 {#r_GDT-getDate__section_xpq_tnr_mcb}

범위가 지정된 애플리케이션에서 getDate() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [getDate()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeGetDate "GlideDateTime 객체에 의해 저장된 날짜를 반환합니다. 표준 형식(yyyy-MM-dd) 및 시스템 시간대(GMT)로 표현됩니다.")를 사용합니다.

## GlideDateTime - getDayOfMonth() {#ariaid-title23}

UTC 시간대의 현재 월을 가져옵니다.
더 이상 사용되지 않음 이 메서드 대신 getDayOfMonthLocalTime() 및 getDayOfMonthUTC()를 사용합니다.
{#r_GDT-getDayOfMonth__table_orj_hg2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 40. 매개변수]

{#r_GDT-getDayOfMonth__table_orj_hg2_nt} {#r_GDT-getDayOfMonth__table_prj_hg2_nt__entry__2}

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

{#r_GDT-getDayOfMonth__table_prj_hg2_nt}  

    var gdt = new GlideDateTime("2011-12-02 12:00:00");
    gs.print(gdt.getDayOfMonth());

출력:

    2

## GlideDateTime - getDayOfMonthLocalTime() {#ariaid-title24}

GlideDateTime 객체에 의해 저장된 월의 일(현재 사용자의 시간대로 표현)을 가져옵니다.
{#r_GDT-getDayOfMonthLocalTime__table_e4r_wg2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 42. 매개변수]

{#r_GDT-getDayOfMonthLocalTime__table_e4r_wg2_nt} {#r_GDT-getDayOfMonthLocalTime__table_f4r_wg2_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | 사용자의 시간대에 있는 월의 일(1에서 31까지)입니다. |
[표 43. 반환]

{#r_GDT-getDayOfMonthLocalTime__table_f4r_wg2_nt}  

    var gdt = new GlideDateTime("2011-12-02 12:00:00");
    gs.print(gdt.getDayOfMonthLocalTime());

출력:

    2

### 범위가 지정된 해당 항목 {#r_GDT-getDayOfMonthLocalTime__section_ap5_d4r_mcb}

범위가 지정된 애플리케이션에서 getDayOfMonthLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [getDayOfMonthLocalTime()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeGetDayOfMonthLocalTime "GlideDateTime 객체에 의해 저장된 월의 일(현재 사용자의 시간대로 표현)을 가져옵니다.")을 사용합니다.

## GlideDateTime - getDayOfMonthUTC() {#ariaid-title25}

GlideDateTime 객체에 의해 저장된 월의 일(UTC 시간대로 표현)을 가져옵니다.
{#r_GDT-getDayOfMonthUTC__table_hhb_nh2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 44. 매개변수]

{#r_GDT-getDayOfMonthUTC__table_hhb_nh2_nt} {#r_GDT-getDayOfMonthUTC__table_ihb_nh2_nt__entry__2}

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

{#r_GDT-getDayOfMonthUTC__table_ihb_nh2_nt}  

    var gdt = new GlideDateTime("2011-12-02 12:00:00");
    gs.print(gdt.getDayOfMonthUTC());

출력:

    2

### 범위가 지정된 해당 항목 {#r_GDT-getDayOfMonthUTC__section_rvd_34r_mcb}

범위가 지정된 애플리케이션에서 getDayOfMonthUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [getDayOfMonthUTC()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeGetDayOfMonthUTC "GlideDateTime 객체에 의해 저장된 월의 일(UTC 시간대로 표현)을 가져옵니다.")를 사용합니다.

## GlideDateTime - getDayOfWeek() {#ariaid-title26}

사용자의 시간대로 표현된 GlideDateTime 객체에 저장된 요일을 조회합니다.
이 메서드 대신 getDayOfWeekLocalTime() 및 getDayOfWeekUTC() 를 사용합니다.
{#r_GDT-getDayOfWeek__table_yvw_zc2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 46. 매개변수]

{#r_GDT-getDayOfWeek__table_yvw_zc2_nt} {#r_GDT-getDayOfWeek__table_zvw_zc2_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | 요일 값 - 월요일 = 1, ... 일요일 = 7. |
[표 47. 반환]

{#r_GDT-getDayOfWeek__table_zvw_zc2_nt}  

    var gdt = new GlideDateTime("2011-12-01 12:00:00");
    gs.print(gdt.getDayOfWeek());

출력:

    4

## GlideDateTime - getDayOfWeekLocalTime() {#ariaid-title27}

사용자의 시간대로 표현된 GlideDateTime 객체에 의해 저장된 요일을 가져옵니다.
{#r_GDT-getDayOfWeekLocalTime__table_xmt_qd2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 48. 매개변수]

{#r_GDT-getDayOfWeekLocalTime__table_xmt_qd2_nt} {#r_GDT-getDayOfWeekLocalTime__table_ymt_qd2_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | 요일 값 - 월요일 = 1, ... 일요일 = 7 |
[표 49. 반환]

{#r_GDT-getDayOfWeekLocalTime__table_ymt_qd2_nt}  

    var gdt = new GlideDateTime("2011-12-01 12:00:00");
    gs.print(gdt.getDayOfWeekLocalTime());

출력:

    4

### 범위가 지정된 해당 항목 {#r_GDT-getDayOfWeekLocalTime__section_lmp_k4r_mcb}

범위가 지정된 애플리케이션에서 getDayOfWeekLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [getDayOfWeekLocalTime()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeGetDayOfWeekLocalTime "사용자의 시간대로 표현된 GlideDateTime 객체에 의해 저장된 요일을 가져옵니다.")을 사용합니다.

## GlideDateTime - getDayOfWeekUTC() {#ariaid-title28}

GlideDateTime 객체에 의해 저장된 요일을 UTC시간대로 표현하여 가져옵니다.
{#r_GDT-getDayOfWeekUTC__table_bwl_b22_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 50. 매개변수]

{#r_GDT-getDayOfWeekUTC__table_bwl_b22_nt} {#r_GDT-getDayOfWeekUTC__table_cwl_b22_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | 요일 값 - 월요일 = 1, ... 일요일 = 7 |
[표 51. 반환]

{#r_GDT-getDayOfWeekUTC__table_cwl_b22_nt}  

    var gdt = new GlideDateTime("2011-12-01 12:00:00");
    gs.print(gdt.getDayOfWeekUTC());

출력:

    4

### 범위가 지정된 해당 항목 {#r_GDT-getDayOfWeekUTC__section_ddt_n4r_mcb}

범위가 지정된 애플리케이션에서 getDayOfWeekUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [getDayOfWeekUTC()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeGetDayOfWeekUTC "GlideDateTime 객체에 의해 저장된 요일을 UTC시간대로 표현하여 반환합니다.")을 사용합니다.

## GlideDateTime - getDaysInMonth() {#ariaid-title29}

GlideDateTime 객체에 의해 저장된 월의 일 수를 가져옵니다(Java Virtual Machine 시간대로 표현됨).
이 메서드 대신 getDaysInMonthLocalTime() 및 getDaysInMonthUTC() 를 사용합니다.
{#r_GDT-getDaysInMonth__table_s3d_yj2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 52. 매개변수]

{#r_GDT-getDaysInMonth__table_s3d_yj2_nt} {#r_GDT-getDaysInMonth__table_t3d_yj2_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | Java Virtual Machine 시간대의 이번 달 일 수입니다. |
[표 53. 반환]

{#r_GDT-getDaysInMonth__table_t3d_yj2_nt}  

    var gdt = new GlideDateTime(); //December
    gs.print(gdt.getDaysInMonth());

출력:

    31

## GlideDateTime - getDaysInMonthLocalTime() {#ariaid-title30}

GlideDateTime 객체에 의해 저장된 월의 일 수를 현재 사용자의 시간대로 표현하여 가져옵니다.
{#r_GDT-getDaysInMonthLocalTime__table_sjf_lk2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 54. 매개변수]

{#r_GDT-getDaysInMonthLocalTime__table_sjf_lk2_nt} {#r_GDT-getDaysInMonthLocalTime__table_tjf_lk2_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | 사용자의 시간대에서 볼 현재 월의 일 수입니다. |
[표 55. 반환]

{#r_GDT-getDaysInMonthLocalTime__table_tjf_lk2_nt}  

    var gdt = new GlideDateTime(); //December
    gs.print(gdt.getDaysInMonthLocalTime());

출력:

    31

### 범위가 지정된 해당 항목 {#r_GDT-getDaysInMonthLocalTime__section_z35_q4r_mcb}

범위가 지정된 애플리케이션에서 getDaysInMonthLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [getDaysInMonthLocalTime()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeGetDaysInMonthLocalTime "GlideDateTime 객체에 의해 저장된 월의 일 수를 현재 사용자의 시간대로 표현하여 가져옵니다.")을 사용합니다.

## GlideDateTime - getDaysInMonthUTC() {#ariaid-title31}

GlideDateTime 객체에 의해 저장된 월의 일 수를 UTC시간대로 구분합니다.
{#r_GDT-getDaysInMonthUTC__table_hwd_ll2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 56. 매개변수]

{#r_GDT-getDaysInMonthUTC__table_hwd_ll2_nt} {#r_GDT-getDaysInMonthUTC__table_iwd_ll2_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | GlideDateTime 객체에 의해 저장된 월의 일 수로, UTC 시간대로 표현됩니다. |
[표 57. 반환]

{#r_GDT-getDaysInMonthUTC__table_iwd_ll2_nt}  

    var gdt = new GlideDateTime(); //December
    gs.print(gdt.getDaysInMonthUTC());

출력:

    31

### 범위가 지정된 해당 항목 {#r_GDT-getDaysInMonthUTC__section_l4t_54r_mcb}

범위가 지정된 애플리케이션에서 getDaysInMonthUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [getDaysInMonthUTC()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeGetDaysInMonthUTC "GlideDateTime 객체에 의해 저장된 월의 일 수를 UTC시간대로 구분합니다.")를 사용합니다.

## GlideDateTime - getDisplayValue() {#ariaid-title32}

현재 사용자의 표시 형식과 시간대에서 날짜 및 시간 값을 가져옵니다.
주:  
GlideDateTime 객체를 참조하면 GMT 표준 시간대의 날짜 및 시간 값이 직접 반환됩니다.
{#r_GDT-getDisplayValue__table_lyf_h1d_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 58. 매개변수]

{#r_GDT-getDisplayValue__table_lyf_h1d_nt} {#r_GDT-getDisplayValue__table_myf_h1d_nt__entry__2}

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

{#r_GDT-getDisplayValue__table_myf_h1d_nt}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gs.info(gdt.getDisplayValue());

출력:

    2011-08-31 01:00:00

### 범위가 지정된 해당 항목 {#r_GDT-getDisplayValue__section_u2f_x4r_mcb}

범위가 지정된 애플리케이션에서 getDisplayValue() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [getDisplayValue()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeGetDisplayValue "현재 사용자의 표시 형식과 시간대에서 날짜 및 시간 값을 가져옵니다.")를 사용합니다.

## GlideDateTime - getDisplayValueInternal() {#ariaid-title33}

표시 값을 내부 형식 yyyy-MM-dd HH:mm:ss로 반환합니다. 이 방법은 날짜/시간 필드에는 유용하지만 날짜 필드에는 유용하지 않습니다.
{#r_GDT-getDisplayValueInternal__table_ocw_t1d_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 60. 매개변수]

{#r_GDT-getDisplayValueInternal__table_ocw_t1d_nt} {#r_GDT-getDisplayValueInternal__table_pcw_t1d_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | GlideDateTime 객체의 날짜 및 시간 값입니다. 형식: yyyy-MM-dd HH:mm:ss(호출자 시간대) |
[표 61. 반환]

{#r_GDT-getDisplayValueInternal__table_pcw_t1d_nt}  

    // The passed in date and time is converted to the caller's time zone.
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gs.info(gdt.getDisplayValueInternal());

출력:

    2011-08-31 01:00:00

### 범위가 지정된 해당 항목 {#r_GDT-getDisplayValueInternal__section_jng_z4r_mcb}

범위가 지정된 애플리케이션에서 getDisplayValueInternal() 메서드를 사용하려면 해당 범위가 지정된 메서드인 [getDisplayValueInternal()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeGetDisplayValueInternal "내부 형식(yyyy-MM-dd HH:mm:ss)의 표시 값을 가져옵니다.")을 사용합니다.

## GlideDateTime - getDisplayValueLang(문자열 스타일) {#ariaid-title34}

지정된 날짜 스타일에 따라 현재 사용자의 로케일로 날짜 및 시간 값을 반환합니다.
{#r_GDT-getDisplayValueLang_S__id_zqf_hvw_dwb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 스타일 | 문자열 | 날짜 및 시간 형식을 지정합니다. 유효한 값은 다음과 같습니다. * 전체: 사용자의 로캘(예: 2022년 10월 24일 월요일)에 따라 \<평일, 월, 일, 연도\> 형식으로 날짜를 반환합니다. * long: 사용자의 로케일(예: 2022년 10월 24일)에 따라 날짜를 \<월, 일, 연도\> 형식으로 반환합니다. * Medium: Long 과 유사하지만 축약된 월이 있는 날짜를 반환합니다(예: 2022년 10월 24일). * short: 사용자의 로케일(예: 2022년 10월 24일 또는 2022년 10월 24일)에 따라 MM/DD/YY 또는 DD/MM/YY 형식으로 날짜를 반환합니다. 다른 값이 전달되면 API는 기본적으로 <var class="keyword varname">medium</var>을 사용합니다. 수락된 값은 대/소문자를 구분하지 않습니다. |
[표 62. 매개변수]

{#r_GDT-getDisplayValueLang_S__id_zqf_hvw_dwb} {#r_GDT-getDisplayValueLang_S__id_pp1_3vw_dwb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 현재 사용자의 로케일에 적합한 형식과 지정된 스타일로 날짜를 문자열로 표현한 것입니다. |
[표 63. 반환]

{#r_GDT-getDisplayValueLang_S__id_pp1_3vw_dwb}  
다음 예제에서는 모든 날짜 스타일에서 사용자 로캘의 날짜 및 시간을 반환합니다.

    var gdt = new GlideDateTime(); // This will fetch the current date


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

    gs.info('date: ' + gdt.getDisplayValueLang("full"));
    gs.info('date: ' + gdt.getDisplayValueLang("long"));
    gs.info('date: ' + gdt.getDisplayValueLang("medium"));
    gs.info('date: ' + gdt.getDisplayValueLang("short"));

출력:

    date: 2023-01-18 06:49:02
    date: Wednesday, January 18, 2023 06:49:02
    date: January 18, 2023 06:49:02
    date: Jan 18, 2023 06:49:02
    date: 1/18/23 06:49:02

## GlideDateTime - getDisplayValueLang(문자열 스타일, 문자열 언어) {#ariaid-title35}

지정된 언어 및 날짜 스타일에 따라 현재 사용자의 로캘에서 날짜 및 시간 값을 반환합니다.
{#r_GDT-getDisplayValueLang_S_S__id_dfb_4vw_dwb__entry__3}

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

{#r_GDT-getDisplayValueLang_S_S__id_dfb_4vw_dwb} {#r_GDT-getDisplayValueLang_S_S__id_v5l_4vw_dwb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 현재 사용자의 로케일에 적합한 형식과 지정된 스타일로 날짜를 문자열로 표현한 것입니다. |
[표 65. 반환]

{#r_GDT-getDisplayValueLang_S_S__id_v5l_4vw_dwb}  
다음 예에서는 모든 언어 및 날짜 스타일로 사용자 로캘의 날짜 및 시간을 반환합니다.

    var gdt = new GlideDateTime(); // This will fetch the current date


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

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

출력:

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

## GlideDateTime - getDSTOffset() {#ariaid-title36}

일광 절약 시간제가 오프셋되는 시간을 가져옵니다.
{#r_GDT-getDSTOffset__table_iyb_vvc_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 66. 매개변수]

{#r_GDT-getDSTOffset__table_iyb_vvc_nt} {#r_GDT-getDSTOffset__table_jyb_vvc_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | 일광 절약 시간이 오프셋되는 시간(밀리초)입니다. 오프셋이 없거나 시간이 일광 절약 시간제가 아닌 경우 0을 반환합니다. |
[표 67. 반환]

{#r_GDT-getDSTOffset__table_jyb_vvc_nt}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gs.print(gdt.getDSTOffset());

출력:

    3600000

### 범위가 지정된 해당 항목 {#r_GDT-getDSTOffset__section_myc_rnr_mcb}

범위가 지정된 애플리케이션에서 getDSTOffset() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [getDSTOffset()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeGetDSTOffset "일광 절약 시간제가 오프셋되는 시간을 가져옵니다.")을 사용합니다.

## GlideDateTime - getErrorMsg() {#ariaid-title37}

현재 오류 메시지를 가져옵니다.
{#r_GDT-getErrorMsg__table_dks_dsl_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 68. 매개변수]

{#r_GDT-getErrorMsg__table_dks_dsl_nt} {#r_GDT-getErrorMsg__table_eks_dsl_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 오류 메시지 |
[표 69. 반환]

{#r_GDT-getErrorMsg__table_eks_dsl_nt}  

    var gdt = new GlideDateTime("2011-aa-31 aa:00:00"); //bad
    gs.print(gdt.isValid()); //false
    gs.print(gdt.getErrorMsg()); //reason

출력:

    false
    Could not parse DateTime: 2011-aa-31 aa:00:00

### 범위가 지정된 해당 항목 {#r_GDT-getErrorMsg__section_hmx_hpr_mcb}

범위가 지정된 애플리케이션에서 getErrorMsg() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [getErrorMsg()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeGetErrorMsg "현재 오류 메시지를 가져옵니다.")를 사용합니다.

## GlideDateTime - getInternalFormattedLocalTime() {#ariaid-title38}

객체의 시간을 로컬 시간대와 내부 형식으로 반환합니다.
{#r_GDT-getInternalFormatedLocalTime__table_izw_h5c_kw__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 70. 매개변수]

{#r_GDT-getInternalFormatedLocalTime__table_izw_h5c_kw} {#r_GDT-getInternalFormatedLocalTime__table_jzw_h5c_kw__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 현지 시간대 및 내부 형식의 객체 시간입니다. |
[표 71. 반환]

{#r_GDT-getInternalFormatedLocalTime__table_jzw_h5c_kw}  
이 예에서는 사용자 시간대의 시스템 시간 형식으로 시간을 표시합니다.

    var gdt = new GlideDateTime('2022-10-08 01:00:00');
    gs.info(gdt.getDisplayValue());
    gs.info(gdt.getInternalFormattedLocalTime());

출력:

    2022-10-07 06:00:00 PM
    18:00:00

### 범위가 지정된 해당 항목 {#r_GDT-getInternalFormatedLocalTime__section_xvx_hc2_dbb}

범위가 지정된 애플리케이션에서 getInternalFormattedLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [getInternalFormattedLocalTime()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_SGDT-getInternalFormattedLocalTime "객체의 시간을 로컬 시간대와 내부 형식으로 반환합니다.")을 사용합니다.

## GlideDateTime - getInternalMidnight(Number dayOfTheWeek) {#ariaid-title39}

UTC를 사용하여 지정된 날의 자정으로 설정된 날짜 및 시간 객체를 반환합니다.
{#r_GDT-getInternalMidnight_N__table_llc_mp2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 주의 날(dayOfTheWeek) | 번호 | 날짜/시간 객체를 반환할 요일입니다. |
[표 72. 매개변수]

{#r_GDT-getInternalMidnight_N__table_llc_mp2_nt} {#r_GDT-getInternalMidnight_N__table_mlc_mp2_nt__entry__2}

| 유형 | 설명 |
|-|-|
| GlideDateTime | 자정으로 설정된 GlideDateTime 객체입니다. |
[표 73. 반환]

{#r_GDT-getInternalMidnight_N__table_mlc_mp2_nt}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gs.print(gdt.getInternalMidnight(2));

출력:

    2011-08-30 00:00:01

## GlideDateTime - getLocalDate() {#ariaid-title40}

GlideDateTime 객체에 의해 저장된 날짜를 가져오며, 표준 형식(yyyy-MM-dd) 및 현재 사용자의 시간대로 표현됩니다.
{#r_GDT-getLocalDate__table_ays_hr2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 74. 매개변수]

{#r_GDT-getLocalDate__table_ays_hr2_nt} {#r_GDT-getLocalDate__table_bys_hr2_nt__entry__2}

| 유형 | 설명 |
|-|-|
| GlideDate | 사용자의 시간대 날짜입니다. |
[표 75. 반환]

{#r_GDT-getLocalDate__table_bys_hr2_nt}  
이 예에서는 사용자의 시간대에서 사용자의 시간 형식으로 시간을 표시합니다.

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gs.print(gdt.getLocalDate());

출력:

    2011-08-31

### 범위가 지정된 해당 항목 {#r_GDT-getLocalDate__section_pg3_lpr_mcb}

범위가 지정된 애플리케이션에서 getLocalDate() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [getLocalDate()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeGetLocalDate "GlideDateTime 객체에 의해 저장된 날짜를 가져오며, 표준 형식(yyyy-MM-dd) 및 현재 사용자의 시간대로 표현됩니다.")를 사용합니다.

## GlideDateTime - getLocalTime() {#ariaid-title41}

사용자의 시간대에서 시간을 가져옵니다.
{#r_GDT-getLocalTime__table_t11_4q2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 76. 매개변수]

{#r_GDT-getLocalTime__table_t11_4q2_nt} {#r_GDT-getLocalTime__table_u11_4q2_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 글라이드타임 | 사용자의 시간대 시간입니다. |
[표 77. 반환]

{#r_GDT-getLocalTime__table_u11_4q2_nt}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gs.print(gdt.getLocalTime());

출력:

    1970-01-01 01:00:00

### 범위가 지정된 해당 항목 {#r_GDT-getLocalTime__section_kqj_4pr_mcb}

범위가 지정된 애플리케이션에서 getLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [getLocalTime()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeGetLocalTime "사용자의 시간대에서 GlideDateTime 객체의 시간 부분을 나타내는 GlideTime 객체를 반환합니다.")을 사용합니다.

## GlideDateTime - getMonth() {#ariaid-title42}

GlideDateTime 객체에 의해 저장된 월을 Java Virtual Machine 시간대로 표현하여 조회합니다.
이 메서드 대신 getMonthLocalTime() 및 getMonthUTC() 를 사용합니다.
{#r_GDT-getMonth__table_pyx_tl2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 78. 매개변수]

{#r_GDT-getMonth__table_pyx_tl2_nt} {#r_GDT-getMonth__table_qyx_tl2_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | 월의 숫자 값, Jan=1, Dec=12입니다. |
[표 79. 반환]

{#r_GDT-getMonth__table_qyx_tl2_nt}  

    var gdt = new GlideDateTime(); //December
    gs.print(gdt.getMonth());

출력:

    12

## GlideDateTime - getMonthLocalTime() {#ariaid-title43}

GlideDateTime 객체에 의해 저장된 월을 현재 사용자의 시간대로 표현하여 가져옵니다.
{#r_GDT-getMonthLocalTime__table_lcb_gm2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 80. 매개변수]

{#r_GDT-getMonthLocalTime__table_lcb_gm2_nt} {#r_GDT-getMonthLocalTime__table_mcb_gm2_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | 월의 숫자 값, Jan=1, Dec=12입니다. |
[표 81. 반환]

{#r_GDT-getMonthLocalTime__table_mcb_gm2_nt}  

    var gdt = new GlideDateTime(); //December
    gs.print(gdt.getMonthLocalTime());

출력:

    12

### 범위가 지정된 해당 항목 {#r_GDT-getMonthLocalTime__section_mts_pvr_mcb}

범위가 지정된 애플리케이션에서 getMonthLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [getMonthLocalTime()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeGetMonthLocalTime "GlideDateTime 객체에 의해 저장된 월을 현재 사용자의 시간대로 표현하여 가져옵니다.")을 사용합니다.

## GlideDateTime - getMonthUTC() {#ariaid-title44}

GlideDateTime 객체에 의해 저장된 월을 UTC시간대로 표현하여 가져옵니다.
{#r_GDT-getMonthUTC__table_bsp_5m2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 82. 매개변수]

{#r_GDT-getMonthUTC__table_bsp_5m2_nt} {#r_GDT-getMonthUTC__table_csp_5m2_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | 월의 숫자 값, Jan=1, Dec=12입니다. |
[표 83. 반환]

{#r_GDT-getMonthUTC__table_csp_5m2_nt}  

    var gdt = new GlideDateTime(); //December
    gs.print(gdt.getMonthUTC());

출력:

    12

### 범위가 지정된 해당 항목 {#r_GDT-getMonthUTC__section_dvn_svr_mcb}

범위가 지정된 애플리케이션에서 getMonthUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [getMonthUTC()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeGetMonthUTC "GlideDateTime 객체에 의해 저장된 월을 UTC시간대로 표현하여 가져옵니다.")를 사용합니다.

## GlideDateTime - getNumericValue() {#ariaid-title45}

1970년 1월 1일 00:00:00 GMT 이후의 밀리초 수를 가져옵니다.
{#r_GDT-getNumericValue__table_vzg_g42_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 84. 매개변수]

{#r_GDT-getNumericValue__table_vzg_g42_nt} {#r_GDT-getNumericValue__table_wzg_g42_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | 1970년 1월 1일 00:00:00 GMT 이후의 밀리초 수입니다. |
[표 85. 반환]

{#r_GDT-getNumericValue__table_wzg_g42_nt}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gs.print(gdt.getNumericValue());

출력:

    1314777600000

## GlideDateTime - getSpanTime(Number dayOfWeek) {#ariaid-title46}

지정된 날의 자정부터 현재 시간까지 경과한 시간을 조회합니다.
{#r_GDT-getSpanTime_N__table_bqw_lf2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| dayOfWeek | 번호 | 1에서 7까지의 요일 값입니다. 1 = 월요일, 7=일요일. |
[표 86. 매개변수]

{#r_GDT-getSpanTime_N__table_bqw_lf2_nt} {#r_GDT-getSpanTime_N__table_cqw_lf2_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 글라이드타임 | 지정된 날짜의 자정 이후 경과한 시간입니다. 결과를 사용자 친화적 용어로 표시하려면 값을 GlideDuration으로 설정합니다. |
[표 87. 반환]

{#r_GDT-getSpanTime_N__table_cqw_lf2_nt}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00"); //Wednesday
    var dur = new GlideDuration();
     
    var span = gdt.getSpanTime(1); //how much time since Monday 00:00:00
    dur.setValue(span);
    gs.print(dur.getDisplayValue());

출력:

    2 Days 8 Hours

## GlideDateTime - getTime() {#ariaid-title47}

Unix 기간 스탬프를 가져옵니다.
{#r_GDT-getTime__table_lny_z42_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 88. 매개변수]

{#r_GDT-getTime__table_lny_z42_nt} {#r_GDT-getTime__table_mny_z42_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 글라이드타임 | GMT 시간을 기준으로 하는 시스템 형식의 Unix 기간 스탬프입니다. |
[표 89. 반환]

{#r_GDT-getTime__table_mny_z42_nt}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gs.print(gdt.getTime());

출력:

    1970-01-01 08:00:00

### 범위가 지정된 해당 항목 {#r_GDT-getTime__section_fjc_xvr_mcb}

범위가 지정된 애플리케이션에서 getTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [getTime()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeGetTime "GlideDateTime 객체의 시간 부분을 나타내는 GlideTime 객체를 반환합니다.")을 사용합니다.

## GlideDateTime - getTZOffset() {#ariaid-title48}

시간대 오프셋(밀리초)을 가져옵니다.
{#r_GDT-getTZOffset__table_nk4_f5l_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 90. 매개변수]

{#r_GDT-getTZOffset__table_nk4_f5l_nt} {#r_GDT-getTZOffset__table_ok4_f5l_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | 시간대 오프셋의 밀리초 수 |
[표 91. 반환]

{#r_GDT-getTZOffset__table_ok4_f5l_nt}  

    var gdt = new GlideDateTime();
    gdt.getLocalTime(); // PST local time
    gs.print(gdt.getTZOffset());

출력:

    -28800000

### 범위가 지정된 해당 항목 {#r_GDT-getTZOffset__section_ihs_5vr_mcb}

범위가 지정된 애플리케이션에서 getTZOffset() 메서드를 사용하려면 해당 범위가 지정된 메서드인 [getTZOffset()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeGetTZOffset "시간대 오프셋(밀리초)을 가져옵니다.")을 사용합니다.

## GlideDateTime - getUserFormattedLocalTime() {#ariaid-title49}

사용자 형식으로 객체의 시간을 현지 시간대로 반환합니다.
{#r_GDT-getUserFormattedLocalTime__table_lgj_ftc_kw__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 92. 매개변수]

{#r_GDT-getUserFormattedLocalTime__table_lgj_ftc_kw} {#r_GDT-getUserFormattedLocalTime__table_mgj_ftc_kw__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 현지 시간과 사용자의 형식인 객체의 시간입니다. |
[표 93. 반환]

{#r_GDT-getUserFormattedLocalTime__table_mgj_ftc_kw}  
다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    var gdt = new GlideDateTime('2022-10-08 01:00:00');
    gs.info(gdt.getDisplayValue());
    gs.info(gdt.getUserFormattedLocalTime());

출력:

    2022-10-07 06:00:00 PM
    06:00:00 PM

### 범위가 지정된 해당 항목 {#r_GDT-getUserFormattedLocalTime__section_hsv_f22_dbb}

범위가 지정된 애플리케이션에서 getUserFormattedLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [getUserFormattedLocalTime()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_SGDT-getUserFormattedLocalTime "객체의 시간을 현지 시간대와 사용자 형식으로 반환합니다.")을 사용합니다.

## GlideDateTime - getUserTimeZone() {#ariaid-title50}

현재 사용자 세션의 시간대를 조회합니다.
이 메서드는 `gs.getSession().getTimeZone()`과 같습니다.
{#r_GDT-getUserTimeZone__table_eyw_b4c_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 94. 매개변수]

{#r_GDT-getUserTimeZone__table_eyw_b4c_nt} {#r_GDT-getUserTimeZone__table_fyw_b4c_nt__entry__2}

| 유형 | 설명 |
|-|-|
| TimeZone | 현재 사용자에 대한 TimeZone 객체입니다. |
[표 95. 반환]

{#r_GDT-getUserTimeZone__table_fyw_b4c_nt}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gs.print(gdt.getUserTimeZone());

출력:

    sun.util.calendar.ZoneInfo[id="America/Los_Angeles",offset=-28800000,dstSavings=3600000,useDaylight=true,transitions=185,
    lastRule=java.util.SimpleTimeZone[id=America/Los_Angeles,offset=-28800000,dstSavings=3600000,useDaylight=true,startYear=0,startMode=3,
    startMonth=2,startDay=8,startDayOfWeek=1,startTime=7200000,startTimeMode=0,endMode=3,endMonth=10,endDay=1,endDayOfWeek=1,
    endTime=7200000,endTimeMode=0]]

## GlideDateTime - getUTCMidnight(Number dayOfTheWeek) {#ariaid-title51}

UTC 시간대를 사용해 시간이 자정으로 설정된 GlideDateTime 객체를 조회합니다.
이 메서드는 새 GlideDateTime 객체의 날짜를 원래 GlideDateTime 객체의 주 내 지정된 요일로 설정합니다.
{#r_GDT-getUTCMidnight_N__table_ezg_zp2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 주의 날(dayOfTheWeek) | 번호 | 요일(1일부터 7까지) 월요일=1, 일요일=7. 이 매개변수에 0을 입력하지 마십시오. |
[표 96. 매개변수]

{#r_GDT-getUTCMidnight_N__table_ezg_zp2_nt} {#r_GDT-getUTCMidnight_N__table_fzg_zp2_nt__entry__2}

| 유형 | 설명 |
|-|-|
| GlideDateTime | 자정으로 설정된 새 GlideDateTime 객체입니다. |
[표 97. 반환]

{#r_GDT-getUTCMidnight_N__table_fzg_zp2_nt}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00"); // Wednesday, 3rd day of the week.
    gs.print(gdt.getUTCMidnight(5)); //Friday, 5th day of the week.

출력:

    2011-09-02 00:00:00

## GlideDateTime - getValue() {#ariaid-title52}

GlideDateTime 객체가 저장한 날짜 및 시간 값을 내부 형식(yyyy-MM-dd HH:mm:ss)으로 UTC 시간대로 반환합니다.
{#r_GDT-getValue__table_osc_gbd_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 98. 매개변수]

{#r_GDT-getValue__table_osc_gbd_nt} {#r_GDT-getValue__table_psc_gbd_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 내부 형식과 시스템 시간대의 날짜 및 시간입니다. 형식: yyyy-MM-dd HH:mm:ss(UTC 시간대) |
[표 99. 반환]

{#r_GDT-getValue__table_psc_gbd_nt}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gs.info(gdt.getValue());

출력:

    2011-08-31 08:00:00

### 범위가 지정된 해당 항목 {#r_GDT-getValue__section_kt5_zvr_mcb}

범위가 지정된 애플리케이션에서 getValue() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [getValue()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeGetValue "GlideDateTime 객체가 저장한 날짜 및 시간 값을 내부 형식(yyyy-MM-dd HH:mm:ss)으로 UTC 시간대로 반환합니다.")를 사용합니다.

## GlideDateTime - getWeekOfYearLocalTime() {#ariaid-title53}

GlideDateTime 객체에 의해 저장된 주 수를 현재 사용자의 시간대로 표현하여 가져옵니다.
모든 주가 일요일에 시작됩니다. 연중 첫째 주는 새해 중 하루 이상 포함된 주입니다. 2015-12-27 일요일에 시작하는 주는 1월 1일과 2일이 포함되므로 2016년의 첫 번째 주로 간주됩니다.
{#r_GDT-getWeekOfYearLocalTime__table_vq5_422_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 100. 매개변수]

{#r_GDT-getWeekOfYearLocalTime__table_vq5_422_nt} {#r_GDT-getWeekOfYearLocalTime__table_wq5_422_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | 현재 주의 숫자입니다. 1년 중 가장 높은 주 수는 52 또는 53입니다. |
[표 101. 반환]

{#r_GDT-getWeekOfYearLocalTime__table_wq5_422_nt}  

    var gdt = new GlideDateTime("2011-12-01 12:00:00");
    gs.print(gdt.getWeekOfYearUTC());

출력:

    49

### 범위가 지정된 해당 항목 {#r_GDT-getWeekOfYearLocalTime__section_yh2_cwr_mcb}

범위가 지정된 애플리케이션에서 getWeekOfYearLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [getWeekOfYearLocalTime()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeGetWeekOfYearLocalTime "GlideDateTime 객체에 의해 저장된 주 수를 현재 사용자의 시간대로 표현하여 가져옵니다.")을 사용합니다.

## GlideDateTime - getWeekOfYearUTC() {#ariaid-title54}

GlideDateTime 객체에 의해 저장된 주 수를 UTC시간대로 표현하여 가져옵니다.
모든 주가 일요일에 시작됩니다. 연중 첫째 주는 새해 중 하루 이상 포함된 주입니다. 2015-12-27 일요일에 시작하는 주는 1월 1일과 2일이 포함되므로 2016년의 첫 번째 주로 간주됩니다.
{#r_GDT-getWeekOfYearUTC__table_jdh_bf2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 102. 매개변수]

{#r_GDT-getWeekOfYearUTC__table_jdh_bf2_nt} {#r_GDT-getWeekOfYearUTC__table_kdh_bf2_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | UTC 시간으로 된 현재 주의 숫자입니다. 1년 중 가장 높은 주 수는 52 또는 53입니다. |
[표 103. 반환]

{#r_GDT-getWeekOfYearUTC__table_kdh_bf2_nt}  

    var gdt = new GlideDateTime("2011-12-01 12:00:00");
    gs.print(gdt.getWeekOfYearUTC());

출력:

    49

### 범위가 지정된 해당 항목 {#r_GDT-getWeekOfYearUTC__section_fpl_2wr_mcb}

범위가 지정된 애플리케이션에서 getWeekOfYearUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [getWeekOfYearUTC()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeGetWeekOfYearUTC "GlideDateTime 객체에 의해 저장된 주 수를 UTC시간대로 표현하여 가져옵니다.")를 사용합니다.

## GlideDateTime - getYear() {#ariaid-title55}

GlideDateTime 객체에 의해 저장된 연도를 Java Virtual Machine 시간대로 표현하여 조회합니다.
이 메서드 대신 getYearLocalTime() 및 getYearUTC() 를 사용합니다.
{#r_GDT-getYear__table_jhh_dn2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 104. 매개변수]

{#r_GDT-getYear__table_jhh_dn2_nt} {#r_GDT-getYear__table_khh_dn2_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | Java Virtual Machine 시간대의 4자리 연도 값입니다. |
[표 105. 반환]

{#r_GDT-getYear__table_khh_dn2_nt}  

    var gdt = new GlideDateTime(); //2011
    gs.print(gdt.getYear());

출력:

    2011

## GlideDateTime - getYearLocalTime() {#ariaid-title56}

현재 사용자의 시간대로 표현된 GlideDateTime 객체에 의해 저장된 연도를 가져옵니다.
{#r_GDT-getYearLocalTime__table_tzz_4n2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 106. 매개변수]

{#r_GDT-getYearLocalTime__table_tzz_4n2_nt} {#r_GDT-getYearLocalTime__table_uzz_4n2_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | 사용자 시간대의 4자리 연도 값입니다. |
[표 107. 반환]

{#r_GDT-getYearLocalTime__table_uzz_4n2_nt}  

    var gdt = new GlideDateTime(); //2011
    gs.print(gdt.getYearLocalTime());

출력:

    2011

### 범위가 지정된 해당 항목 {#r_GDT-getYearLocalTime__section_dys_jwr_mcb}

범위가 지정된 애플리케이션에서 getYearLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [getYearLocalTime()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeGetYearLocalTime "현재 사용자의 시간대로 표현된 GlideDateTime 객체에 의해 저장된 연도를 가져옵니다.")을 사용합니다.

## GlideDateTime - getYearUTC() {#ariaid-title57}

GlideDateTime 객체에 의해 저장된 연도를 UTC시간대로 반환합니다.
{#r_GDT-getYearUTC__table_dml_xn2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 108. 매개변수]

{#r_GDT-getYearUTC__table_dml_xn2_nt} {#r_GDT-getYearUTC__table_eml_xn2_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | UTC 시간대의 4자리 연도 값입니다. |
[표 109. 반환]

{#r_GDT-getYearUTC__table_eml_xn2_nt}  

    var gdt = new GlideDateTime(); //2011
    gs.info(gdt.getYearUTC());

출력:

    2011

### 범위가 지정된 해당 항목 {#r_GDT-getYearUTC__section_j4m_pwr_mcb}

범위가 지정된 애플리케이션에서 getYearUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [getYearUTC()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeGetYearUTC "GlideDateTime 객체에 의해 저장된 연도를 UTC시간대로 표현하여 가져옵니다.")를 사용합니다.

## GlideDateTime - hasDate() {#ariaid-title58}

객체의 날짜가 설정되었는지 여부를 결정합니다.
{#r_GDT-hasDate__table_iqj_rnc_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 110. 매개변수]

{#r_GDT-hasDate__table_iqj_rnc_nt} {#r_GDT-hasDate__table_jqj_rnc_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 객체의 날짜가 설정되어 있으면 True이고 그렇지 않으면 False입니다. |
[표 111. 반환]

{#r_GDT-hasDate__table_jqj_rnc_nt}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gs.print(gdt.hasDate());

출력:

    true

### 범위가 지정된 해당 항목 {#r_GDT-hasDate__section_yzp_rwr_mcb}

범위가 지정된 애플리케이션에서 hasDate() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [hasDate()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeHasDate "객체의 날짜가 설정되었는지 여부를 결정합니다.")를 사용합니다.

## GlideDateTime - isDST() {#ariaid-title59}

객체의 시간에 일광 절약 시간 오프셋을 사용할지 여부를 결정합니다.
{#r_GDT-isDST__table_ncy_jvc_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 112. 매개변수]

{#r_GDT-isDST__table_ncy_jvc_nt} {#r_GDT-isDST__table_ocy_jvc_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 시간이 일광 절약 시간제이면 예이고 그렇지 않으면 아니오입니다. |
[표 113. 반환]

{#r_GDT-isDST__table_ocy_jvc_nt}  

    var gdt = new GlideDateTime("2011-08-31 00:00:00");
    gs.print(gdt.isDST()); //true

출력:

    true

### 범위가 지정된 해당 항목 {#r_GDT-isDST__section_gns_twr_mcb}

범위가 지정된 애플리케이션에서 isDST() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [isDST()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeIsDST "객체의 시간에 일광 절약 시간 오프셋을 사용할지 여부를 결정합니다.")를 사용합니다.

## GlideDateTime - isValid() {#ariaid-title60}

값이 유효한 날짜 및 시간인지 여부를 결정합니다.
{#r_GDT-isValid__table_sfh_5rl_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 114. 매개변수]

{#r_GDT-isValid__table_sfh_5rl_nt} {#r_GDT-isValid__table_tfh_5rl_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 값이 유효하면 예이고 그렇지 않으면 아니오입니다. |
[표 115. 반환]

{#r_GDT-isValid__table_tfh_5rl_nt}  

    var gdt = new GlideDateTime("2011-aa-31 aa:00:00"); 
    gs.print(gdt.isValid()); //true
    gs.print(gdt.getErrorMsg()); //reason

출력

    Invalid date time: '2011-aa-31 aa:00:00', ignored

### 범위가 지정된 해당 항목 {#r_GDT-isValid__section_flp_vwr_mcb}

범위가 지정된 애플리케이션에서 isValid() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [isValid()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeIsValid "값이 유효한 날짜 및 시간인지 여부를 결정합니다.")를 사용합니다.

## GlideDateTime - setDayOfMonth(숫자 일) {#ariaid-title61}

월의 일을 지정된 값으로 설정합니다.
이 메서드 대신 setDayOfMonthLocalTime(day) 및 setDayOfMonthUTC(day) 를 사용합니다.
{#r_GDT-setDayOfMonth_N__table_pp4_vh2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 일 | 번호 | 달의 날짜, 1일부터 31까지. |
[표 116. 매개변수]

{#r_GDT-setDayOfMonth_N__table_pp4_vh2_nt} {#r_GDT-setDayOfMonth_N__table_qp4_vh2_nt__entry__2}

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

{#r_GDT-setDayOfMonth_N__table_qp4_vh2_nt}  

    var gdt = new GlideDateTime();
    gdt.setDayOfMonth(9);
    gs.print(gdt.getDayOfMonth());

출력:

    9

## GlideDateTime - setDayOfMonthLocalTime(숫자 일) {#ariaid-title62}

월의 일을 현재 사용자의 시간대에 지정된 값으로 설정합니다.
{#r_GDT-setDayOfMonthLocalTime_N__table_bvc_1j2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 일 | 번호 | 1에서 31로 변경할 날짜입니다. 이 값이 해당 월의 최대 일 수보다 크면 값이 해당 월의 마지막 날로 설정됩니다. |
[표 118. 매개변수]

{#r_GDT-setDayOfMonthLocalTime_N__table_bvc_1j2_nt} {#r_GDT-setDayOfMonthLocalTime_N__table_cvc_1j2_nt__entry__2}

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

{#r_GDT-setDayOfMonthLocalTime_N__table_cvc_1j2_nt}  

    var gdt = new GlideDateTime();
    gdt.setDayOfMonthLocalTime(9);
    gs.print(gdt.getDayOfMonthLocalTime());

출력:

    9

### 범위가 지정된 해당 항목 {#r_GDT-setDayOfMonthLocalTime_N__section_p4c_ywr_mcb}

범위가 지정된 애플리케이션에서 setDayOfMonthLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [setDayOfMonthLocalTime()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeSetDayOfMonthLocalTime_Number_day "월의 일을 현재 사용자의 시간대에 지정된 값으로 설정합니다.")을 사용합니다.

## GlideDateTime - setDayOfMonthUTC(숫자 일) {#ariaid-title63}

월의 일을 UTC 시간대의 지정된 값으로 설정합니다.
{#r_GDT-setDayOfMonthUTC_N__table_mmk_mj2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 일 | 번호 | 1에서 31로 변경할 날짜입니다. 이 값이 해당 월의 최대 일 수보다 크면 값이 해당 월의 마지막 날로 설정됩니다. |
[표 120. 매개변수]

{#r_GDT-setDayOfMonthUTC_N__table_mmk_mj2_nt} {#r_GDT-setDayOfMonthUTC_N__table_nmk_mj2_nt__entry__2}

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

{#r_GDT-setDayOfMonthUTC_N__table_nmk_mj2_nt}  

    var gdt = new GlideDateTime();
    gdt.setDayOfMonthUTC(9);
    gs.print(gdt.getDayOfMonthUTC());

출력:

    9

### 범위가 지정된 해당 항목 {#r_GDT-setDayOfMonthUTC_N__section_rxh_1xr_mcb}

범위가 지정된 애플리케이션에서 setDayOfMonthUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [setDayOfMonthUTC()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeSetDayOfMonthUTC_Number_day "월의 일을 UTC 시간대의 지정된 값으로 설정합니다.")를 사용합니다.

## GlideDateTime - setDisplayValue(문자열 asDisplayed) {#ariaid-title64}

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

| 이름 | 유형 | 설명 |
|-|-|-|
| asDisplayed | 문자열 | 현재 사용자의 표시 형식과 시간대의 날짜 및 시간입니다. 매개변수는 현재 사용자가 선호하는 표시 형식(예: MM-dd-yyyy HH:mm:ss)을 사용하여 형식을 지정해야 합니다. 워크플로우 스크립트의 변수에 현재 날짜와 시간을 할당하려면 `<variable>.setDisplayValue(gs.nowDateTime);를 사용하십시오.` |
[표 122. 매개변수]

{#r_GDT-setDisplayValue_S__table_jnc_fwc_nt} {#r_GDT-setDisplayValue_S__table_knc_fwc_nt__entry__2}

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

{#r_GDT-setDisplayValue_S__table_knc_fwc_nt}  

    var gdt = new GlideDateTime("2011-02-02 12:00:00");
    gdt.setDisplayValue("2011-01-01 12:00:00");
    gs.print(gdt.getValue());

출력:

    2011-01-01 20:00:00

### 범위가 지정된 해당 항목 {#r_GDT-setDisplayValue_S__section_wyq_2xr_mcb}

범위가 지정된 애플리케이션에서 setDisplayValue() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [setDisplayValue()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeSetDisplayValue_String_asDisplayed "현재 사용자의 표시 형식과 시간대를 사용하여 날짜 및 시간 값을 설정합니다.")를 사용합니다.

## GlideDateTime - setDisplayValue(문자열 dateTime, 문자열 형식) {#ariaid-title65}

현재 사용자의 시간대와 지정된 날짜 및 시간 형식을 사용하여 날짜 및 시간 값을 설정합니다.
이 메서드는 dateTime 매개변수에 사용된 날짜 및 시간 형식이 format 매개변수와 일치하지 않으면 런타임 예외를 발생시킵니다. 예외가 포착된 후 GlideDateTime 객체에서 getErrorMsg() 를 호출하여 오류 메시지를 검색할 수 있습니다.
{#r_GDT-setDisplayValue_S_S__table_dqz_pzc_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 날짜/시간 | 문자열 | 현재 사용자의 시간대에 있는 날짜 및 시간입니다. |
| format | 문자열 | dateTime 매개변수를 구문 분석하는 데 사용할 형식입니다. |
[표 124. 매개변수]

{#r_GDT-setDisplayValue_S_S__table_dqz_pzc_nt} {#r_GDT-setDisplayValue_S_S__table_eqz_pzc_nt__entry__2}

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

{#r_GDT-setDisplayValue_S_S__table_eqz_pzc_nt}  

    var gdt = new GlideDateTime("2011-02-02 12:00:00");
    gdt.setDisplayValue("20-5-2011 12:00:00", "dd-MM-yyyy HH:mm:ss");
    gs.print(gdt.getValue());

출력:

    2011-05-20 19:00:00

### 범위가 지정된 해당 항목 {#r_GDT-setDisplayValue_S_S__section_zns_gxr_mcb}

범위가 지정된 애플리케이션에서 setDisplayValue() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [setDisplayValue()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeSetDisplayValue_String_value_String_format "현재 사용자의 시간대와 지정된 날짜 및 시간 형식을 사용하여 날짜 및 시간 값을 설정합니다.")를 사용합니다.

## GlideDateTime - setDisplayValueInternal(문자열 dateTime) {#ariaid-title66}

내부 형식(yyyy-MM-dd, HH:mm:ss)과 현재 사용자의 시간대를 사용하여 날짜 및 시간 값을 설정합니다.
{#r_GDT-setDisplayValueInternal_S__table_zrg_5wc_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 날짜/시간 | 문자열 | 내부 형식의 날짜 및 시간 |
[표 126. 매개변수]

{#r_GDT-setDisplayValueInternal_S__table_zrg_5wc_nt} {#r_GDT-setDisplayValueInternal_S__table_asg_5wc_nt__entry__2}

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

{#r_GDT-setDisplayValueInternal_S__table_asg_5wc_nt}  

    var gdt = new GlideDateTime("2011-02-02 12:00:00");
    gdt.setDisplayValueInternal("2011-01-01 12:00:00");
    gs.print(gdt.getValue());

출력:

    2011-01-01 20:00:00

### 범위가 지정된 해당 항목 {#r_GDT-setDisplayValueInternal_S__section_hrc_cxr_mcb}

범위가 지정된 애플리케이션에서 setDisplayValueInternal() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [setDisplayValueInternal()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeSetDisplayValueInternal_String_value "내부 형식(yyyy-MM-dd, HH:mm:ss)과 현재 사용자의 시간대를 사용하여 날짜 및 시간 값을 설정합니다.")을 사용합니다.

## GlideDateTime - setDisplayValueInternalWithAlternates(문자열 dateTime) {#ariaid-title67}

내부 형식(yyyy-MM-dd, HH:mm:ss)과 현재 사용자의 시간대를 사용하여 날짜 및 시간 값을 설정합니다.
이 메서드는 불완전한 날짜 및 시간 값을 구문 분석하려고 시도합니다.
{#r_GDT-setDispValInternalAlt_S__table_ipl_dzc_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 날짜/시간 | 문자열 | 내부 형식의 날짜 및 시간입니다. |
[표 128. 매개변수]

{#r_GDT-setDispValInternalAlt_S__table_ipl_dzc_nt} {#r_GDT-setDispValInternalAlt_S__table_jpl_dzc_nt__entry__2}

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

{#r_GDT-setDispValInternalAlt_S__table_jpl_dzc_nt}

## GlideDateTime - setDisplayValueLang(String dateTime, String style) {#ariaid-title68}

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

| 이름 | 유형 | 설명 |
|-|-|-|
| 날짜/시간 | 문자열 | 현재 사용자의 시간대에 있는 GlideDate 객체의 날짜 및 시간 값입니다. 유효한 값은 getDisplayValueLang() 함수에서 출력된 모든 날짜 및 시간입니다. 예를 들어 이 주제 앞부분의 getDisplayValueLang(문자열 스타일, 문자열 언어) 예제의 출력을 사용하면 2022년 11월 28일 07:03:41 또는 28.11.2022 07:03:41 이 허용되는 값입니다. |
| 스타일 | 문자열 | 날짜 형식을 지정합니다. 유효한 값은 다음과 같습니다. * 전체: 사용자의 로캘(예: 2022년 10월 24일 월요일)에 따라 \<평일, 월, 일, 연도\> 형식으로 날짜를 반환합니다. * long: 사용자의 로케일(예: 2022년 10월 24일)에 따라 날짜를 \<월, 일, 연도\> 형식으로 반환합니다. * Medium: Long 과 유사하지만 축약된 월이 있는 날짜를 반환합니다(예: 2022년 10월 24일). * short: 사용자의 로케일(예: 2022년 10월 24일 또는 2022년 10월 24일)에 따라 MM/DD/YY 또는 DD/MM/YY 형식으로 날짜를 반환합니다. 다른 값이 전달되면 API는 기본적으로 <var class="keyword varname">medium</var>을 사용합니다. 수락된 값은 대/소문자를 구분하지 않습니다. |
[표 130. 매개변수]

{#r_GDT-setDisplayValueLang_S_S__id_jjl_xvw_dwb} {#r_GDT-setDisplayValueLang_S_S__id_e41_yvw_dwb__entry__2}

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

{#r_GDT-setDisplayValueLang_S_S__id_e41_yvw_dwb}  
다음 예시에서는 날짜와 시간을 짧은 스타일과 전체 스타일로 반환합니다.

    var glideDateFR = new GlideDateTime();
    glideDateFR.setDisplayValueLang("2/3/2023 17:27:56", "short");

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

출력:

    date: 2023-02-03 17:27:56
    date: Friday, February 3, 2023 17:27:56

## GlideDateTime - setDisplayValueLang(String dateTime, 문자열 스타일, 문자열 언어) {#ariaid-title69}

현재 사용자의 로케일에 따라 지정된 스타일, 언어 및 형식을 사용하여 날짜와 시간을 설정합니다.
{#r_GDT-setDisplayValueLang_S_S_S__id_zks_2ww_dwb__entry__3}

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

{#r_GDT-setDisplayValueLang_S_S_S__id_zks_2ww_dwb} {#r_GDT-setDisplayValueLang_S_S_S__id_rg3_fww_dwb__entry__2}

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

{#r_GDT-setDisplayValueLang_S_S_S__id_rg3_fww_dwb}  
다음 예제에서는 영어와 프랑스어에 대해 날짜와 시간을 짧고 전체 스타일로 반환합니다.

    var glideDateFR = new GlideDateTime(); 

    glideDateUS.setDisplayValueLang("2/3/2023 18:00:00", "short", "en-US" );
    glideDateFR.setDisplayValueLang("2/3/2023 18:00:00", "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 18:00:00
    en-US date: Friday, February 3, 2023 18:00:00
    fr-FR date: 2023-03-02 18:00:00
    fr-FR date: Thursday, March 2, 2023 18:00:00

## GlideDateTime - setGlideDateTime(GlideDateTime gDT) {#ariaid-title70}

기존 GlideDateTime 객체를 사용하여 현재 객체의 날짜 및 시간을 설정합니다.
이 메서드는 GlideDateTime 매개변수를 사용하여 새 개체를 인스턴스화하는 것과 같습니다.
{#r_GDT-setGlideDateTime_GDT__table_xdg_y5c_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| gDT | GlideDateTime | GlideDateTime 객체 |
[표 134. 매개변수]

{#r_GDT-setGlideDateTime_GDT__table_xdg_y5c_nt} {#r_GDT-setGlideDateTime_GDT__table_ydg_y5c_nt__entry__2}

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

{#r_GDT-setGlideDateTime_GDT__table_ydg_y5c_nt}  

    var dt1 = new GlideDateTime("2011-01-01 12:00:00");
    var dt2 = new GlideDateTime("2011-02-02 08:00:00");
    dt1.setGlideDateTime(dt2);
    gs.print(dt1.getValue());

출력:

    2011-02-02 08:00:00

### 범위가 지정된 해당 항목 {#r_GDT-setGlideDateTime_GDT__section_fjw_3xr_mcb}

범위가 지정된 애플리케이션에서 setGlideDateTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [setGlideDateTime()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeSetGlideDateTime_g "기존 GlideDateTime 객체를 사용하여 현재 객체의 날짜 및 시간을 설정합니다. 이 메서드는 GlideDateTime 매개변수를 사용하여 새 개체를 인스턴스화하는 것과 같습니다.")을 사용합니다.

## GlideDateTime - setInitialValue(문자열 dateTime) {#ariaid-title71}

날짜와 시간을 설정합니다.
이 메서드는 setValue(Object)와 같습니다.
{#r_GDT-setInitialValue_S__table_i42_r5l_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 날짜/시간 | 문자열 | 사용할 날짜 및 시간입니다. 내부 형식으로 GMT 시간대의 문자열 또는 GlideDateTime 객체를 허용합니다. |
[표 136. 매개변수]

{#r_GDT-setInitialValue_S__table_i42_r5l_nt} {#r_GDT-setInitialValue_S__table_j42_r5l_nt__entry__2}

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

{#r_GDT-setInitialValue_S__table_j42_r5l_nt}  

    var gdt = new GlideDateTime();
    gdt.setInitialValue("2011-01-01 12:00:00");
    gs.print(gdt.getValue());

출력:

    2011-01-01 12:00:00

## GlideDateTime - setMonth(숫자 월) {#ariaid-title72}

Java Virtual Machine 시간대를 사용하여 GlideDateTime 객체에 의해 저장된 월을 지정된 값으로 설정합니다.
이 메서드 대신 setMonthLocalTime() 또는 setMonthUTC() 를 사용합니다.
{#r_GDT-setMonth_N__table_djd_3wl_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 월 | 번호 | 변경할 월입니다. |
[표 138. 매개변수]

{#r_GDT-setMonth_N__table_djd_3wl_nt} {#r_GDT-setMonth_N__table_ejd_3wl_nt__entry__2}

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

{#r_GDT-setMonth_N__table_ejd_3wl_nt}  

    var gdt = new GlideDateTime();
    gdt.setMonth(1);
    gs.print(gdt.getMonth());

출력:

    1

## GlideDateTime - setMonthLocalTime(숫자 월) {#ariaid-title73}

현재 사용자의 시간대를 사용하여 GlideDateTime 객체에 의해 저장된 월을 지정된 값으로 설정합니다.
{#r_GDT-setMonthLocalTime_N__table_xgm_wwl_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 월 | 번호 | 변경할 월입니다. |
[표 140. 매개변수]

{#r_GDT-setMonthLocalTime_N__table_xgm_wwl_nt} {#r_GDT-setMonthLocalTime_N__table_ygm_wwl_nt__entry__2}

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

{#r_GDT-setMonthLocalTime_N__table_ygm_wwl_nt}  

    var gdt = new GlideDateTime();
    gdt.setMonthLocalTime(1);
    gs.print(gdt.getMonthLocalTime());

출력:

    1

### 범위가 지정된 해당 항목 {#r_GDT-setMonthLocalTime_N__section_rqq_lxr_mcb}

범위가 지정된 애플리케이션에서 setMonthLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [setMonthLocalTime()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeSetMonthLocalTime_Number "현재 사용자의 시간대를 사용하여 GlideDateTime 객체에 의해 저장된 월을 지정된 값으로 설정합니다.")을 사용합니다.

## GlideDateTime - setMonthUTC(숫자 월) {#ariaid-title74}

GlideDateTime 객체에 의해 저장된 월을 UTC 시간대를 사용하여 지정된 값으로 설정합니다.
{#r_GDT-setMonthUTC_N__table_gt5_fxl_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 월 | 번호 | 변경할 월입니다. |
[표 142. 매개변수]

{#r_GDT-setMonthUTC_N__table_gt5_fxl_nt} {#r_GDT-setMonthUTC_N__table_ht5_fxl_nt__entry__2}

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

{#r_GDT-setMonthUTC_N__table_ht5_fxl_nt}  

    var gdt = new GlideDateTime();
    gdt.setMonthUTC(1);
    gs.print(gdt.getMonthUTC());

출력:

    1

### 범위가 지정된 해당 항목 {#r_GDT-setMonthUTC_N__section_xyx_nxr_mcb}

범위가 지정된 애플리케이션에서 setMonthUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [setMonthUTC()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeSetMonthUTC_Number "UTC 시간대를 사용하여 GlideDateTime 객체에 의해 저장된 월을 지정된 값으로 설정합니다.")를 사용합니다.

## GlideDateTime - setNumericValue(밀리초) {#ariaid-title75}

날짜 및 시간을 1970년 1월 1일 00:00:00 GMT 이후의 밀리초 수로 설정합니다.
{#r_GDT-setNumericValue_N__table_jsf_q42_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 밀리초 | 번호 | 밀리초 수 |
[표 144. 매개변수]

{#r_GDT-setNumericValue_N__table_jsf_q42_nt} {#r_GDT-setNumericValue_N__table_ksf_q42_nt__entry__2}

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

{#r_GDT-setNumericValue_N__table_ksf_q42_nt}  

    var gdt = new GlideDateTime();
    gdt.setNumericValue(1314777600000);
    gs.print(gdt.getValue());

출력:

    2011-08-31 08:00:00

## GlideDateTime - setTZ(시간대 시간대) {#ariaid-title76}

GlideDateTime 객체의 시간대를 지정된 시간대로 설정합니다.
{#r_GDT-setTZ_TZ__table_uy3_54c_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 시간대 | TimeZone | 시간대 객체 |
[표 146. 매개변수]

{#r_GDT-setTZ_TZ__table_uy3_54c_nt} {#r_GDT-setTZ_TZ__table_vy3_54c_nt__entry__2}

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

{#r_GDT-setTZ_TZ__table_vy3_54c_nt}  

    var tz = gs.getSession().getTimeZone();
    var gdt = new GlideDateTime(); 
    gdt.setTZ(tz);

## GlideDateTime - setValue(객체 dateTime) {#ariaid-title77}

GlideDateTime 객체의 날짜와 시간을 설정합니다.
이 메서드는 setInitialValue()와 같습니다.
{#r_GDT-setValue_O__table_yfh_fpc_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 날짜/시간 | 객체 | 사용할 날짜 및 시간입니다. 이 매개변수는 여러 유형 중 하나일 수 있습니다. * UTC 시간대의 문자열과 yyyy-MM-dd HH:mm:ss의 내부 형식: 객체의 값을 지정된 날짜 및 시간으로 설정합니다. 이 방법을 사용하는 것은 GlideDateTime(value) 생성자를 사용하여 새 GlideDateTime 객체를 인스턴스화하는 것과 같습니다. 사용된 날짜 및 시간 형식이 내부 형식과 일치하지 않으면 메서드는 사용 가능한 다른 형식을 사용하여 날짜 및 시간을 설정하려고 시도합니다. 이러한 방법으로 날짜와 시간을 확인하면 일 및 월 값의 모호함으로 인해 데이터가 부정확해질 수 있습니다. 표준이 아닌 날짜 및 시간 형식을 사용하는 경우에는 setValueUTC(dateTime, format) 를 대신 사용합니다. * GlideDateTime 객체: 객체의 값을 매개변수에 전달된 GlideDateTime에 의해 저장된 날짜 및 시간으로 설정합니다. 이 방법을 사용하는 것은 GlideDateTime(g) 생성자를 사용하여 새 GlideDateTime 개체를 인스턴스화하는 것과 같습니다. * Java Date 객체: Java Date 객체에 저장된 값을 사용하여 객체의 값을 설정합니다. 이 방법으로 메서드를 사용하는 것은 Java Date 객체 getTime() 에서 반환한 값을 GlideDateTime setNumericValue() 메서드에 전달하는 것과 같습니다. 이 메서드는 JavaScript 날짜 객체를 허용하지 않습니다. * JavaScript 번호: 1970년 1월 1일 00:00:00 UTC를 지나는 밀리초 단위로 숫자 값을 사용하여 객체의 값을 설정합니다. 이 방법으로 메서드를 사용하는 것은 setNumericValue(밀리초) 메서드와 같습니다. * Java 정수 또는 Long: 정수 또는 Long 값을 사용하여 1970년 1월 1일 00:00:00 UTC를 지나는 밀리초로 객체의 값을 설정합니다. 이 방법으로 메서드를 사용하는 것은 setNumericValue(밀리초) 메서드와 같습니다. {#r_GDT-setValue_O__ul_j3h_4pc_nt} |
[표 148. 매개변수]

{#r_GDT-setValue_O__table_yfh_fpc_nt} {#r_GDT-setValue_O__table_zfh_fpc_nt__entry__2}

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

{#r_GDT-setValue_O__table_zfh_fpc_nt}  
yyyy-MM-dd HH:mm:ss 형식의 문자열을 사용하여 날짜 및 시간을 설정합니다.

    var gdt = new GlideDateTime("2011-01-01 12:00:00");
    gdt.setValue("2011-02-02 08:00:00");
    gs.print(gdt.getValue());

출력:

    2011-02-02 08:00:00

기존 GlideDateTime 객체를 사용하여 날짜 및 시간을 설정합니다.

    var gdtSource = new GlideDateTime("2017-05-23 11:37:41");
    var gdtDest = new GlideDateTime();
    gdtDest.setValue(gdtSource);
    gs.print(gdtDest.getValue());

출력:

    2017-05-23 11:37:41

1970년 1월 1일 00:00:00 UTC를 지나는 밀리초를 나타내는 숫자로 날짜와 시간을 설정합니다.

    var gdt = new GlideDateTime("2011-01-01 12:00:00");
    gdt.setValue(1617634522375);
    gs.print(gdt.getValue());

출력:

    2021-04-05 14:55:22

### 범위가 지정된 해당 항목 {#r_GDT-setValue_O__section_w2m_sxr_mcb}

범위가 지정된 애플리케이션에서 setValue() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [setValue()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeSetValue_String_o "GlideDateTime 객체의 날짜와 시간을 설정합니다.")를 사용합니다.

## GlideDateTime - setValueUTC(문자열 dateTime, 문자열 형식) {#ariaid-title78}

UTC 시간대와 지정된 날짜 및 시간 형식을 사용하여 날짜 및 시간 값을 설정합니다.
이 메서드는 dateTime 매개변수에 사용된 날짜 및 시간 형식이 format 매개변수와 일치하지 않으면 런타임 예외를 발생시킵니다. 예외가 포착된 후 GlideDateTime 객체에서 getErrorMsg() 를 호출하여 오류 메시지를 검색할 수 있습니다.
{#r_GDT-setValueUTC_S_S__table_p5w_35c_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 날짜/시간 | 문자열 | 사용할 날짜 및 시간입니다. |
| format | 문자열 | 사용할 형식입니다. |
[표 150. 매개변수]

{#r_GDT-setValueUTC_S_S__table_p5w_35c_nt} {#r_GDT-setValueUTC_S_S__table_q5w_35c_nt__entry__2}

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

{#r_GDT-setValueUTC_S_S__table_q5w_35c_nt}  

    var gdt = new GlideDateTime("2011-01-01 12:00:00");
    gdt.setValueUTC("15-02-2011 08:00:00", "dd-MM-yyyy HH:mm:ss");
    gs.print(gdt.getValue());

출력:

    2011-02-15 08:00:00

### 범위가 지정된 해당 항목 {#r_GDT-setValueUTC_S_S__section_ft1_qxr_mcb}

범위가 지정된 애플리케이션에서 setValueUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [setValueUTC()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeSetValueUTC_String_dt_String_format "UTC 시간대와 지정된 날짜 및 시간 형식을 사용하여 날짜 및 시간 값을 설정합니다. 이 메서드는 매개변수에 사용된 날짜 및 시간 형식이 매개변수와 일치하지 않으면 런타임 예외를 dt 발생시킵니다.format 예외가 포착된 후 GlideDateTime 객체에서 getErrorMsg() 를 호출하여 오류 메시지를 검색할 수 있습니다.")를 사용합니다.

## GlideDateTime - setYear(Number year) {#ariaid-title79}

Java Virtual Machine 시간대를 사용하여 GlideDateTime 객체에 의해 저장된 연도를 지정된 값으로 설정합니다.
이 메서드 대신 setYearLocalTime() 또는 setYearUTC() 를 사용합니다.
{#r_GDT-setYear_N__table_tgf_4xl_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 년 | 번호 | 변경할 연도입니다. |
[표 152. 매개변수]

{#r_GDT-setYear_N__table_tgf_4xl_nt} {#r_GDT-setYear_N__table_ugf_4xl_nt__entry__2}

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

{#r_GDT-setYear_N__table_ugf_4xl_nt}  

    var gdt = new GlideDateTime();
    gdt.setYear(2013);
    gs.print(gdt.getYear());

출력:

    2013

## GlideDateTime - setYearLocalTime(번호 연도) {#ariaid-title80}

현재 사용자의 시간대를 사용하여 GlideDateTime 객체에 의해 저장된 연도를 지정된 값으로 설정합니다.
{#r_GDT-setYearLocalTime_N__table_vp4_1yl_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 년 | 번호 | 변경할 연도입니다. |
[표 154. 매개변수]

{#r_GDT-setYearLocalTime_N__table_vp4_1yl_nt} {#r_GDT-setYearLocalTime_N__table_wp4_1yl_nt__entry__2}

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

{#r_GDT-setYearLocalTime_N__table_wp4_1yl_nt}  

    var gdt = new GlideDateTime();
    gdt.setYearLocalTime(2013);
    gs.print(gdt.getYearLocalTime());

출력:

    2013

### 범위가 지정된 해당 항목 {#r_GDT-setYearLocalTime_N__section_mjw_5xr_mcb}

범위가 지정된 애플리케이션에서 setYearLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [setYearLocalTime()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeSetYearLocalTime_Number "현재 사용자의 시간대를 사용하여 GlideDateTime 객체에 의해 저장된 연도를 지정된 값으로 설정합니다.")을 사용합니다.

## GlideDateTime - setYearUTC(숫자 연도) {#ariaid-title81}

GlideDateTime 객체에 의해 저장된 연도를 UTC 시간대를 사용하여 지정된 값으로 설정합니다.
{#r_GDT-setYearUTC_N__table_fzh_jyl_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 년 | 번호 | 변경할 연도입니다. |
[표 156. 매개변수]

{#r_GDT-setYearUTC_N__table_fzh_jyl_nt} {#r_GDT-setYearUTC_N__table_gzh_jyl_nt__entry__2}

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

{#r_GDT-setYearUTC_N__table_gzh_jyl_nt}  

    var gdt = new GlideDateTime();
    gdt.setYearUTC(2013);
    gs.print(gdt.getYearUTC());

출력:

    2013

### 범위가 지정된 해당 항목 {#r_GDT-setYearUTC_N__section_q3v_wxr_mcb}

범위가 지정된 애플리케이션에서 setYearUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [setYearUTC()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeSetYearUTC_Number "UTC 시간대를 사용하여 GlideDateTime 객체에 의해 저장된 연도를 지정된 값으로 설정합니다.")를 사용합니다.

## GlideDateTime - 빼기(GlideTime 시간) {#ariaid-title82}

지정된 시간을 뺍니다.
{#r_GDT-subtract_GT__table_lsb_nzk_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 시간 | 글라이드타임 | 뺄 시간 |
[표 158. 매개변수]

{#r_GDT-subtract_GT__table_lsb_nzk_nt} {#r_GDT-subtract_GT__table_msb_nzk_nt__entry__2}

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

{#r_GDT-subtract_GT__table_msb_nzk_nt}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    var gtime1 = new GlideTime();
    gtime1.setValue("00:00:20");
    gdt.subtract(gtime1);
    gs.print(gdt.getTime());

출력:

    1970-01-01 07:59:40

### 범위가 지정된 해당 항목 {#r_GDT-subtract_GT__section_ltp_byr_mcb}

범위가 지정된 애플리케이션에서 subtract() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [subtract()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeSubtract_GlideTime "현재 GlideDateTime 객체에서 지정된 시간을 뺍니다.")를 사용합니다.

## GlideDateTime - 빼기(밀리초) {#ariaid-title83}

GlideDateTime 객체에서 지정된 시간(밀리초)을 뺍니다.
{#r_GDT-subtract_N__table_r54_mtl_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 밀리초 | 번호 | 뺄 시간(밀리초) |
[표 160. 매개변수]

{#r_GDT-subtract_N__table_r54_mtl_nt} {#r_GDT-subtract_N__table_s54_mtl_nt__entry__2}

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

{#r_GDT-subtract_N__table_s54_mtl_nt}  

    var gdt = new GlideDateTime("2011-12-07 08:00:00");
    gdt.subtract(1000);
    gs.print(gdt.getValue());

출력:

    2011-12-07 07:59:59

### 범위가 지정된 해당 항목 {#r_GDT-subtract_N__section_ihx_qyr_mcb}

범위가 지정된 애플리케이션에서 subtract() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [subtract()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeSubtract_Number "GlideDateTime 객체에서 지정된 시간(밀리초)을 뺍니다.")를 사용합니다.

## GlideDateTime - subtract(GlideDateTime start, GlideDateTime end) {#ariaid-title84}

지정된 두 GlideDateTime 객체 간의 기간 차이를 반환합니다.
{#r_GDT-subtract_GDT_GDT__table_gn2_grl_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 시작 | GlideDateTime | 시작 날짜 객체입니다. |
| 끝 | GlideDateTime | 종료 날짜 객체입니다. |
[표 162. 매개변수]

{#r_GDT-subtract_GDT_GDT__table_gn2_grl_nt} {#r_GDT-subtract_GDT_GDT__table_hn2_grl_nt__entry__2}

| 유형 | 설명 |
|-|-|
| GlideDuration | 지정된 두 날짜 간의 기간 차이입니다. |
[표 163. 반환]

{#r_GDT-subtract_GDT_GDT__table_hn2_grl_nt}  

    var gdt1 = new GlideDateTime("2011-08-28 09:00:00");
    var gdt2 = new GlideDateTime("2011-08-31 08:00:00");
     
    var dur = GlideDateTime.subtract(gdt1, gdt2); // Difference between gdt1 and gdt2
    gs.info(dur.getDisplayValue());

출력:

    2 Days 23 Hours

### 범위가 지정된 해당 항목 {#r_GDT-subtract_GDT_GDT__section_apm_zxr_mcb}

범위가 지정된 애플리케이션에서 subtract() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [subtract()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeSubtract_GlideDateTime_GlideDate_Time "지정된 두 GlideDateTime 객체 간의 기간 차이를 반환합니다.")를 사용합니다.

## GlideDateTime - toString() {#ariaid-title85}

GlideDateTime 객체가 저장한 날짜 및 시간 값을 내부 형식(yyyy-MM-dd HH:mm:ss) 및 시스템 시간대(기본적으로 UTC)로 반환합니다.
이 메서드는 getValue()와 동일합니다.
{#r_GDT-toString__table_lyw_ls2_nt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 164. 매개변수]

{#r_GDT-toString__table_lyw_ls2_nt} {#r_GDT-toString__table_myw_ls2_nt__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | GlideDateTime 객체가 시스템 시간대와 형식으로 저장한 날짜 및 시간입니다. |
[표 165. 반환]

{#r_GDT-toString__table_myw_ls2_nt}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gs.print(gdt.toString());

출력:

    2011-08-31 08:00:00

### 범위가 지정된 해당 항목 {#r_GDT-toString__section_fxf_tyr_mcb}

범위가 지정된 애플리케이션에서 toString() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [toString()](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#r_ScopedGlideDateTimeToString "GlideDateTime 객체가 저장한 날짜 및 시간 값을 내부 형식(yyyy-MM-dd HH:mm:ss)과 시스템 시간대(기본적으로 UTC)로 가져옵니다. 이 메서드는 getValue()와 동일합니다.")을 사용합니다.