---
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) 소요 시간: 45분

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

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

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

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

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

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

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

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

출력:

    2022-08-08 16:51:44

## 범위가 지정된 GlideDateTime - GlideDateTime(문자열 값) {#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_ScopedGlideDateTimeGlideDateTime_String_value__ul_xgq_hmz_lnb}  
주:  
다음 형식은 지원되지 않습니다.

* yyyy-MM-dd'T'HH:mm:ss. SSSZ
{#r_ScopedGlideDateTimeGlideDateTime_String_value__ul_udg_d5w_lcc}
{#r_ScopedGlideDateTimeGlideDateTime_String_value__table_vy2_525_jq__entry__3}

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

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

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

출력:

    2023-01-01 12:00:00

## 범위가 지정된 GlideDateTime - GlideDateTime(GlideDateTime g) {#ariaid-title4}

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

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

{#r_ScopedGlideDateTimeGlideDateTime_GlideDateTime_g__table_vy2_525_jq}  
이 예제에서는 `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(GlideTime gd) {#ariaid-title5}

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

| 이름 | 유형 | 설명 |
|-|-|-|
| gd | 글라이드타임 | 지정된 GlideDateTime 객체에 추가할 시간 값의 GlideTime 객체입니다. |
[표 4. 매개변수]

{#r_ScopedGlideDateTimeAdd_GlideTime_gd__table_vy2_525_jq} {#r_ScopedGlideDateTimeAdd_GlideTime_gd__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeAdd_GlideTime_gd__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    var gtime1 = new GlideTime();
    gtime1.setValue("00:00:20");
    gdt.add(gtime1);
    var gtime2 = gdt.getTime();
    gs.info(gtime2.getByFormat('hh:mm:ss'));

출력:

    08:00:20

## 범위가 지정된 GlideDateTime - add(숫자 밀리초) {#ariaid-title6}

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

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

{#r_ScopedGlideDateTimeAdd_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeAdd_Number__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeAdd_Number__table_qpt_3f5_jq}  

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

출력:

    1314777600000 1314777600010

## 범위가 지정된 GlideDateTime - addDaysLocalTime(일 수) {#ariaid-title7}

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

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

{#r_ScopedGlideDateTimeAddDaysLocalTime_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeAddDaysLocalTime_Number__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeAddDaysLocalTime_Number__table_qpt_3f5_jq}  

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

출력:

    2011-08-30

## 범위가 지정된 GlideDateTime - addDaysUTC(일 수) {#ariaid-title8}

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

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

{#r_ScopedGlideDateTimeAddDaysUTC_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeAddDaysUTC_Number__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeAddDaysUTC_Number__table_qpt_3f5_jq}  

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

출력:

     2011-08-30

## 범위가 지정된 GlideDateTime - addMonthsLocalTime(월 수) {#ariaid-title9}

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

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

{#r_ScopedGlideDateTimeAddMonthsLocalTime_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeAddMonthsLocalTime_Number__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeAddMonthsLocalTime_Number__table_qpt_3f5_jq}  

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

출력:

    2011-10-31

## 범위가 지정된 GlideDateTime - addMonthsUTC(월 수) {#ariaid-title10}

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

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

{#r_ScopedGlideDateTimeAddMonthsUTC_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeAddMonthsUTC_Number__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeAddMonthsUTC_Number__table_qpt_3f5_jq}  

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

출력:

    2011-10-31

## 범위가 지정된 GlideDateTime - addSeconds(숫자 초) {#ariaid-title11}

현재 GlideDateTime 객체에 지정된 시간(초)을 추가합니다.
{#r_ScopedGlideDateTimeAddSeconds_Number__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeAddSeconds_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeAddSeconds_Number__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeAddSeconds_Number__table_qpt_3f5_jq}  

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

출력:

    2011-12-07 08:16:40

## 범위가 지정된 GlideDateTime - addWeeksLocalTime(주 수) {#ariaid-title12}

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

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

{#r_ScopedGlideDateTimeAddWeeksLocalTime_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeAddWeeksLocalTime_Number__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeAddWeeksLocalTime_Number__table_qpt_3f5_jq}  

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

출력:

    2011-08-24

## 범위가 지정된 GlideDateTime - addWeeksUTC(주 수) {#ariaid-title13}

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

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

{#r_ScopedGlideDateTimeAddWeeksUTC_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeAddWeeksUTC_Number__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeAddWeeksUTC_Number__table_qpt_3f5_jq}  

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

출력:

    2011-08-24

## 범위가 지정된 GlideDateTime - addYearsLocalTime(년 수) {#ariaid-title14}

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

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

{#r_ScopedGlideDateTimeAddYearsLocalTime_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeAddYearsLocalTime_Number__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeAddYearsLocalTime_Number__table_qpt_3f5_jq}  

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

출력:

    2011-08-31

## 범위가 지정된 GlideDateTime - addYearsUTC(Number years) {#ariaid-title15}

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

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

{#r_ScopedGlideDateTimeAddYearsUTC_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeAddYearsUTC_Number__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeAddYearsUTC_Number__table_qpt_3f5_jq}  

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

출력:

    2011-08-31

## 범위가 지정된 GlideDateTime - after(GlideDateTime gdt) {#ariaid-title16}

GlideDateTime 객체의 날짜 및 시간이 지정된 객체의 날짜 및 시간 이후에 발생하는지 여부를 결정합니다.
{#r_SGDT-after_GDT__table_op2_nqq_yv__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| gdt | GlideDateTime | 검사할 날짜 및 시간입니다. |
[표 26. 매개변수]

{#r_SGDT-after_GDT__table_op2_nqq_yv} {#r_SGDT-after_GDT__table_pp2_nqq_yv__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | GlideDateTime 객체의 날짜 및 시간이 매개변수에 의해 지정된 날짜 및 시간 이후인지 여부를 나타내는 플래그입니다. 가능한 값: * true: GlideDateTime 객체 날짜 및 시간이 지정된 객체의 날짜 및 시간 이후입니다. * false: GlideDateTime 객체 날짜 및 시간이 지정된 객체의 날짜 및 시간 이전이거나 같습니다. {#r_SGDT-after_GDT__ul_xcn_m2j_zpb} |
[표 27. 반환]

{#r_SGDT-after_GDT__table_pp2_nqq_yv}  

    var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
    var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
    gs.info(gdt1.after(gdt2)); 

출력:

    False

## 범위가 지정된 GlideDateTime - 이전(GlideDateTime gdt) {#ariaid-title17}

GlideDateTime 객체의 날짜 및 시간이 지정된 GlideDateTime 객체의 날짜 및 시간 전에 발생하는지 여부를 결정합니다.
{#r_SGDT-before_GDT__table_j5h_vrq_yv__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| gdt | GlideDateTime | 검사할 날짜 및 시간입니다. |
[표 28. 매개변수]

{#r_SGDT-before_GDT__table_j5h_vrq_yv} {#r_SGDT-before_GDT__table_k5h_vrq_yv__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | GlideDateTime 객체의 날짜 및 시간이 매개변수에 의해 지정된 날짜 및 시간 이전인지 여부를 나타내는 플래그입니다. 가능한 값: * true: GlideDateTime 객체 날짜 및 시간이 지정된 날짜 및 시간 이전입니다. * false: GlideDateTime 객체 날짜 및 시간이 지정된 날짜 및 시간 이후이거나 같습니다. {#r_SGDT-before_GDT__ul_xcn_m2j_zpb} |
[표 29. 반환]

{#r_SGDT-before_GDT__table_k5h_vrq_yv}  

    var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
    var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
    gs.info(gdt1.before(gdt2));  

출력

    true

## 범위가 지정된 GlideDateTime - compareTo(Object o) {#ariaid-title18}

두 날짜 및 시간 객체를 비교하여 두 날짜 및 시간 객체가 동일한지 또는 다른 객체의 이전 또는 이후에 발생하는지 확인합니다.
{#r_ScopedGlideDateTimeCompareTo_Object_o__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeCompareTo_Object_o__table_vy2_525_jq} {#r_ScopedGlideDateTimeCompareTo_Object_o__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeCompareTo_Object_o__table_qpt_3f5_jq}  

    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

## 범위가 지정된 GlideDateTime - equals(객체 dateTime) {#ariaid-title19}

날짜/시간을 기존 값과 비교하여 동일성을 확인합니다.
{#r_ScopedGlideDateTimeEquals_Object__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 날짜/시간 | GlideDateTime 객체 또는 문자열 | 비교할 날짜/시간입니다. |
[표 32. 매개변수]

{#r_ScopedGlideDateTimeEquals_Object__table_vy2_525_jq} {#r_ScopedGlideDateTimeEquals_Object__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 같으면 예를 반환합니다. 그렇지 않으면 false입니다. |
[표 33. 반환]

{#r_ScopedGlideDateTimeEquals_Object__table_qpt_3f5_jq}  

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

출력:

    false

## 범위가 지정된 GlideDateTime - getDate() {#ariaid-title20}

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

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

{#r_ScopedGlideDateTimeGetDate__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetDate__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 시스템 시간대의 날짜입니다. |
[표 35. 반환]

{#r_ScopedGlideDateTimeGetDate__table_qpt_3f5_jq}  

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

출력:

    2011-08-31

## 범위가 지정된 GlideDateTime - getDayOfMonthLocalTime() {#ariaid-title21}

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

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

{#r_ScopedGlideDateTimeGetDayOfMonthLocalTime__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetDayOfMonthLocalTime__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeGetDayOfMonthLocalTime__table_qpt_3f5_jq}  

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

출력:

    2

## 범위가 지정된 GlideDateTime - getDayOfMonthUTC() {#ariaid-title22}

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

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

{#r_ScopedGlideDateTimeGetDayOfMonthUTC__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetDayOfMonthUTC__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeGetDayOfMonthUTC__table_qpt_3f5_jq}  

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

출력:

    02

## 범위가 지정된 GlideDateTime - getDayOfWeekLocalTime() {#ariaid-title23}

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

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

{#r_ScopedGlideDateTimeGetDayOfWeekLocalTime__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetDayOfWeekLocalTime__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | 사용자의 시간대에서 1에서 7까지의 요일 값입니다. 월요일은 1, 일요일은 7입니다. |
[표 41. 반환]

{#r_ScopedGlideDateTimeGetDayOfWeekLocalTime__table_qpt_3f5_jq}  

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

출력:

    4

## 범위가 지정된 GlideDateTime - getDayOfWeekUTC() {#ariaid-title24}

GlideDateTime 객체에 의해 저장된 요일을 UTC시간대로 표현하여 반환합니다.
{#r_ScopedGlideDateTimeGetDayOfWeekUTC__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeGetDayOfWeekUTC__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetDayOfWeekUTC__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | 1에서 7까지의 요일 값입니다. 월요일은 1, 일요일은 7입니다. |
[표 43. 반환]

{#r_ScopedGlideDateTimeGetDayOfWeekUTC__table_qpt_3f5_jq}  

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

출력:

    4

## 범위가 지정된 GlideDateTime - getDaysInMonthLocalTime() {#ariaid-title25}

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

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

{#r_ScopedGlideDateTimeGetDaysInMonthLocalTime__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetDaysInMonthLocalTime__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeGetDaysInMonthLocalTime__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-12-02 12:00:00"); //December
    gs.info(gdt.getDaysInMonthLocalTime());

출력:

    30

## 범위가 지정된 GlideDateTime - getDaysInMonthUTC() {#ariaid-title26}

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

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

{#r_ScopedGlideDateTimeGetDaysInMonthUTC__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetDaysInMonthUTC__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeGetDaysInMonthUTC__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
    gs.info(gdt.getDaysInMonthUTC());

출력:

    30

## 범위가 지정된 GlideDateTime - getDisplayValue() {#ariaid-title27}

현재 사용자의 표시 형식과 시간대에서 날짜 및 시간 값을 가져옵니다.
{#r_ScopedGlideDateTimeGetDisplayValue__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeGetDisplayValue__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetDisplayValue__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeGetDisplayValue__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    gs.info(gdt.getDisplayValue()); //uses current user session time zone (US/Pacific)

출력:

    2011-08-31 01:00:00

## 범위가 지정된 GlideDateTime - getDisplayValueInternal() {#ariaid-title28}

내부 형식(yyyy-MM-dd HH:mm:ss)의 표시 값을 가져옵니다.
{#r_ScopedGlideDateTimeGetDisplayValueInternal__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeGetDisplayValueInternal__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetDisplayValueInternal__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 현재 사용자의 시간대에 있는 GlideDateTime 객체의 날짜 및 시간 값과 `yyyy-MM-dd HH:mm:ss`의 내부 날짜 및 시간 형식입니다. |
[표 51. 반환]

{#r_ScopedGlideDateTimeGetDisplayValueInternal__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00"); 
    gs.info(gdt.getDisplayValueInternal()); //uses current user session time zone (US/Pacific)

출력:

    2011-08-31 01:00:00

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

지정된 언어 및 날짜 스타일에 따라 현재 사용자의 로캘에서 날짜 및 시간 값을 반환합니다.
{#r_SGDT-getDisplayValueLang_S_S__id_wvq_jww_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/) 참조하세요. |
[표 52. 매개변수]

{#r_SGDT-getDisplayValueLang_S_S__id_wvq_jww_dwb} {#r_SGDT-getDisplayValueLang_S_S__id_sdf_kww_dwb__entry__2}

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

{#r_SGDT-getDisplayValueLang_S_S__id_sdf_kww_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-title30}

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

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

{#r_ScopedGlideDateTimeGetDSTOffset__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetDSTOffset__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeGetDSTOffset__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2014-08-31 08:00:00"); 
    gs.info(gdt.getDSTOffset()); //uses current user session time zone (US/Pacific)

출력:

    3600000

## 범위가 지정된 GlideDateTime - getErrorMsg() {#ariaid-title31}

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

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

{#r_ScopedGlideDateTimeGetErrorMsg__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetErrorMsg__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 오류 메시지입니다. |
[표 57. 반환]

{#r_ScopedGlideDateTimeGetErrorMsg__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime(); 
    gdt.setDisplayValue("2011-aa-01 00:00:00"); 
    gs.info(gdt.getErrorMsg());

출력:

    Could not parse DateTime: 2011-aa-01 00:00:00

## 범위가 지정된 GlideDateTime - getInternalFormattedLocalTime() {#ariaid-title32}

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

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

{#r_SGDT-getInternalFormattedLocalTime__table_lvp_5vc_kw} {#r_SGDT-getInternalFormattedLocalTime__table_mvp_5vc_kw__entry__2}

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

{#r_SGDT-getInternalFormattedLocalTime__table_mvp_5vc_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

## 범위가 지정된 GlideDateTime - getLocalDate() {#ariaid-title33}

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

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

{#r_ScopedGlideDateTimeGetLocalDate__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetLocalDate__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeGetLocalDate__table_qpt_3f5_jq}  

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

출력:

    2011-08-31

## 범위가 지정된 GlideDateTime - getLocalTime() {#ariaid-title34}

사용자의 시간대에서 GlideDateTime 객체의 시간 부분을 나타내는 GlideTime 객체를 반환합니다.
{#r_ScopedGlideDateTimeGetLocalTime__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeGetLocalTime__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetLocalTime__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeGetLocalTime__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2014-08-31 08:00:00");
    gt = gdt.getLocalTime();
    gs.info("local time is " + gt.getByFormat('hh:mm:ss'));

출력:

    local time is 01:00:00

## 범위가 지정된 GlideDateTime - getMonthLocalTime() {#ariaid-title35}

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

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

{#r_ScopedGlideDateTimeGetMonthLocalTime__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetMonthLocalTime__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeGetMonthLocalTime__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
    gs.info(gdt.getMonthLocalTime());

출력:

    11

## 범위가 지정된 GlideDateTime - getMonthUTC() {#ariaid-title36}

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

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

{#r_ScopedGlideDateTimeGetMonthUTC__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetMonthUTC__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeGetMonthUTC__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
    gs.info(gdt.getMonthUTC());

출력:

    11

## 범위가 지정된 GlideDateTime - getNumericValue() {#ariaid-title37}

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

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

{#r_ScopedGlideDateTimeNumericValue__table_vy2_525_jq} {#r_ScopedGlideDateTimeNumericValue__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeNumericValue__table_qpt_3f5_jq}  

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

출력:

    1314777600000

## 범위가 지정된 GlideDateTime - getTime() {#ariaid-title38}

GlideDateTime 객체의 시간 부분을 나타내는 GlideTime 객체를 반환합니다.
{#r_ScopedGlideDateTimeGetTime__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeGetTime__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetTime__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeGetTime__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2014-08-31 08:00:00");
    gt = gdt.getTime();
    gs.info(gt.getByFormat('hh:mm:ss'));

출력:

    08:00:00

## 범위가 지정된 GlideDateTime - getTZOffset() {#ariaid-title39}

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

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

{#r_ScopedGlideDateTimeGetTZOffset__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetTZOffset__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeGetTZOffset__table_qpt_3f5_jq}  

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

출력:

    -25200000

## 범위가 지정된 GlideDateTime - getUserFormattedLocalTime() {#ariaid-title40}

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

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

{#r_SGDT-getUserFormattedLocalTime__table_ddv_fvc_kw} {#r_SGDT-getUserFormattedLocalTime__table_edv_fvc_kw__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 현지 시간대와 사용자 형식으로 된 객체의 시간입니다. |
[표 75. 반환]

{#r_SGDT-getUserFormattedLocalTime__table_edv_fvc_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

## 범위가 지정된 GlideDateTime - getValue() {#ariaid-title41}

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

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

{#r_ScopedGlideDateTimeGetValue__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetValue__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeGetValue__table_qpt_3f5_jq}  

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

출력:

    2014-08-31 08:00:00

## 범위가 지정된 GlideDateTime - getWeekOfYearLocalTime() {#ariaid-title42}

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

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

{#r_ScopedGlideDateTimeGetWeekOfYearLocalTime__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetWeekOfYearLocalTime__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeGetWeekOfYearLocalTime__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-12-01 12:00:00");//49th week, 1st week in december 
    gs.info(gdt.getWeekOfYearLocalTime());

출력:

    49

## 범위가 지정된 GlideDateTime - getWeekOfYearUTC() {#ariaid-title43}

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

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

{#r_ScopedGlideDateTimeGetWeekOfYearUTC__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetWeekOfYearUTC__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeGetWeekOfYearUTC__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-12-01 12:00:00");//49th week, 1st week in December 
    gs.info(gdt.getWeekOfYearUTC());

출력:

    49

## 범위가 지정된 GlideDateTime - getYearLocalTime() {#ariaid-title44}

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

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

{#r_ScopedGlideDateTimeGetYearLocalTime__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetYearLocalTime__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeGetYearLocalTime__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-11-02 12:00:00");
    gs.info(gdt.getYearLocalTime());

출력:

    2011

## 범위가 지정된 GlideDateTime - getYearUTC() {#ariaid-title45}

GlideDateTime 객체에 의해 저장된 연도를 UTC시간대로 표현하여 가져옵니다.
{#r_ScopedGlideDateTimeGetYearUTC__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeGetYearUTC__table_vy2_525_jq} {#r_ScopedGlideDateTimeGetYearUTC__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeGetYearUTC__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-11-02 12:00:00"); 
    gs.info(gdt.getYearUTC());

출력:

    2011

## 범위가 지정된 GlideDateTime - hasDate() {#ariaid-title46}

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

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

{#r_ScopedGlideDateTimeHasDate__table_vy2_525_jq} {#r_ScopedGlideDateTimeHasDate__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 객체 날짜가 설정된 경우 예입니다. 그렇지 않으면 아니오를 반환합니다. |
[표 87. 반환]

{#r_ScopedGlideDateTimeHasDate__table_qpt_3f5_jq}  

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

출력:

    true

## 범위가 지정된 GlideDateTime - isDST() {#ariaid-title47}

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

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

{#r_ScopedGlideDateTimeIsDST__table_vy2_525_jq} {#r_ScopedGlideDateTimeIsDST__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeIsDST__table_qpt_3f5_jq}  

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

출력:

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

## 범위가 지정된 GlideDateTime - isValid() {#ariaid-title48}

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

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

{#r_ScopedGlideDateTimeIsValid__table_vy2_525_jq} {#r_ScopedGlideDateTimeIsValid__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 값이 유효한 경우 예입니다. 그렇지 않으면 아니오를 반환합니다. |
[표 91. 반환]

{#r_ScopedGlideDateTimeIsValid__table_qpt_3f5_jq}  

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

출력:

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

## 범위가 지정된 GlideDateTime - onOrAfter(GlideDateTime gdt) {#ariaid-title49}

GlideDateTime 객체의 데이터 및 시간이 지정된 GlideDateTime 객체의 날짜 및 시간 또는 그 이후에 발생하는지 여부를 결정합니다.
{#r_SGDT-onOrAfter_GDT__table_sst_nsq_yv__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| gdt | GlideDateTime | 검사할 날짜 및 시간입니다. |
[표 92. 매개변수]

{#r_SGDT-onOrAfter_GDT__table_sst_nsq_yv} {#r_SGDT-onOrAfter_GDT__table_tst_nsq_yv__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | GlideDateTime 객체의 날짜 및 시간이 매개변수에 의해 지정된 날짜 및 시간과 동일한지 또는 그 이후인지 여부를 나타내는 플래그입니다. 가능한 값: * true: GlideDateTime 객체 날짜 및 시간이 지정된 객체의 날짜 및 시간과 같거나 그 이후입니다. * 아니오: GlideDateTime 객체의 날짜 및 시간이 지정된 객체의 날짜 및 시간 이전입니다. {#r_SGDT-onOrAfter_GDT__ul_xcn_m2j_zpb} |
[표 93. 반환]

{#r_SGDT-onOrAfter_GDT__table_tst_nsq_yv}  

    var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
    var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
    gs.info(gdt1.onOrAfter(gdt2));   

출력

    false

## 범위가 지정된 GlideDateTime - onOrBefore(GlideDateTime gdt) {#ariaid-title50}

GlideDateTime 객체의 데이터 및 시간이 지정된 GlideDateTime 객체의 날짜 및 시간 또는 그 이전에 발생하는지 여부를 결정합니다.
{#r_SGDT-onOrBefore_GDT__table_srp_2tq_yv__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| gdt | GlideDateTime | 검사할 날짜 및 시간입니다. |
[표 94. 매개변수]

{#r_SGDT-onOrBefore_GDT__table_srp_2tq_yv} {#r_SGDT-onOrBefore_GDT__table_trp_2tq_yv__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | GlideDateTime 객체의 날짜 및 시간이 매개변수에 의해 지정된 날짜 및 시간과 같거나 이전인지 여부를 나타내는 플래그입니다. 가능한 값: * true: GlideDateTime 객체 날짜 및 시간이 지정된 객체의 날짜 및 시간과 같거나 이전입니다. * 아니오: GlideDateTime 객체 날짜 및 시간이 지정된 객체의 날짜 및 시간 이후입니다. {#r_SGDT-onOrBefore_GDT__ul_xcn_m2j_zpb} |
[표 95. 반환]

{#r_SGDT-onOrBefore_GDT__table_trp_2tq_yv}  

    var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
    var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
    gs.info(gdt1.onOrBefore(gdt2));   

출력

    true

## 범위가 지정된 GlideDateTime - setDayOfMonthLocalTime(숫자 일) {#ariaid-title51}

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

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

{#r_ScopedGlideDateTimeSetDayOfMonthLocalTime_Number_day__table_vy2_525_jq} {#r_ScopedGlideDateTimeSetDayOfMonthLocalTime_Number_day__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeSetDayOfMonthLocalTime_Number_day__table_qpt_3f5_jq}  

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

출력:

    9

## 범위가 지정된 GlideDateTime - setDayOfMonthUTC(숫자 일) {#ariaid-title52}

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

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

{#r_ScopedGlideDateTimeSetDayOfMonthUTC_Number_day__table_vy2_525_jq} {#r_ScopedGlideDateTimeSetDayOfMonthUTC_Number_day__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeSetDayOfMonthUTC_Number_day__table_qpt_3f5_jq}  

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

출력:

    9

## 범위가 지정된 GlideDateTime - setDisplayValue(문자열 asDisplayed) {#ariaid-title53}

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

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

{#r_ScopedGlideDateTimeSetDisplayValue_String_asDisplayed__table_vy2_525_jq} {#r_ScopedGlideDateTimeSetDisplayValue_String_asDisplayed__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeSetDisplayValue_String_asDisplayed__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2014-02-02 12:00:00");
    gdt.setDisplayValue("2014-01-01 12:00:00");//uses current user session time zone (US/Pacific) 
    gs.info(gdt.getValue());

출력:

    2014-01-01 20:00:00

## 범위가 지정된 GlideDateTime - setDisplayValue(문자열 값, 문자열 형식) {#ariaid-title54}

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

| 이름 | 유형 | 설명 |
|-|-|-|
| 값 | 문자열 | 현재 사용자의 시간대로 된 날짜 및 시간입니다. |
| format | 문자열 | 매개변수를 구문 분석하는 데 사용할 날짜 및 시간 형식입니다 value . 다음 값을 사용하여 매개변수를 설명합니다.value * dd: 일(월 중) * MM: 연도의 월 * yyyy: 연도 * HH: 시간 * mm: 분 * ss: 초 {#r_ScopedGlideDateTimeSetDisplayValue_String_value_String_format__ul_h13_nvr_ckb} 예: "dd-MM-yyyy HH:mm:ss" 또는 "MM-dd-yyyy HH:mm". |
[표 102. 매개변수]

{#r_ScopedGlideDateTimeSetDisplayValue_String_value_String_format__table_vy2_525_jq} {#r_ScopedGlideDateTimeSetDisplayValue_String_value_String_format__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeSetDisplayValue_String_value_String_format__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-02-02 12:00:00");
    gdt.setDisplayValue("20-5-2011 12:00:00", "dd-MM-yyyy HH:mm:ss"); //uses current user session time zone
    gs.info(gdt.getValue());

출력

    "20-05-2011 12:00:00"

## 범위가 지정된 GlideDateTime - setDisplayValueInternal(String value) {#ariaid-title55}

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

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

{#r_ScopedGlideDateTimeSetDisplayValueInternal_String_value__table_vy2_525_jq} {#r_ScopedGlideDateTimeSetDisplayValueInternal_String_value__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeSetDisplayValueInternal_String_value__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2014-02-02 12:00:00");
    gdt.setDisplayValueInternal("2014-01-01 12:00:00"); //uses current user session time zone (US/Pacific)
    gs.info(gdt.getValue());

출력:

    2014-01-01 20:00:00

## 범위가 지정된 GlideDateTime - setDisplayValueLang(문자열, dateTime, 문자열 style) {#ariaid-title56}

현재 사용자의 로케일에 따라 지정된 스타일과 형식을 사용하여 날짜와 시간을 설정합니다.
{#r_SGDT-setDisplayValueLang_S_S__id_wc2_nww_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>을 사용합니다. 수락된 값은 대/소문자를 구분하지 않습니다. |
[표 106. 매개변수]

{#r_SGDT-setDisplayValueLang_S_S__id_wc2_nww_dwb} {#r_SGDT-setDisplayValueLang_S_S__id_srr_nww_dwb__entry__2}

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

{#r_SGDT-setDisplayValueLang_S_S__id_srr_nww_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(문자열 dateTime, 문자열 스타일, 문자열 언어) {#ariaid-title57}

현재 사용자의 로케일에 따라 지정된 스타일, 언어 및 형식을 사용하여 날짜와 시간을 설정합니다.
{#r_SGDT-setDisplayValueLang_S_S_S__id_sgm_qww_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/) 참조하세요. |
[표 108. 매개변수]

{#r_SGDT-setDisplayValueLang_S_S_S__id_sgm_qww_dwb} {#r_SGDT-setDisplayValueLang_S_S_S__id_nst_qww_dwb__entry__2}

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

{#r_SGDT-setDisplayValueLang_S_S_S__id_nst_qww_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 g) {#ariaid-title58}

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

| 이름 | 유형 | 설명 |
|-|-|-|
| g | GlideDateTime | 날짜/시간 값을 설정하는 데 사용할 객체입니다. |
[표 110. 매개변수]

{#r_ScopedGlideDateTimeSetGlideDateTime_g__table_vy2_525_jq} {#r_ScopedGlideDateTimeSetGlideDateTime_g__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeSetGlideDateTime_g__table_qpt_3f5_jq}  

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

출력:

    2011-02-02 08:00:00

## 범위가 지정된 GlideDateTime - setMonthLocalTime(숫자 월) {#ariaid-title59}

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

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

{#r_ScopedGlideDateTimeSetMonthLocalTime_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeSetMonthLocalTime_Number__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeSetMonthLocalTime_Number__table_qpt_3f5_jq}  

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

출력:

    1

## 범위가 지정된 GlideDateTime - setMonthUTC(숫자 월) {#ariaid-title60}

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

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

{#r_ScopedGlideDateTimeSetMonthUTC_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeSetMonthUTC_Number__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeSetMonthUTC_Number__table_qpt_3f5_jq}  

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

출력:

    1

## 범위가 지정된 GlideDateTime - setValue(String o) {#ariaid-title61}

GlideDateTime 객체의 날짜와 시간을 설정합니다.
{#r_ScopedGlideDateTimeSetValue_String_o__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeSetValue_String_o__table_vy2_525_jq} {#r_ScopedGlideDateTimeSetValue_String_o__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeSetValue_String_o__table_qpt_3f5_jq}  

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

출력:

    2011-02-02 08:00:00

## 범위가 지정된 GlideDateTime - setValueUTC(문자열 dt, 문자열 형식) {#ariaid-title62}

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

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

{#r_ScopedGlideDateTimeSetValueUTC_String_dt_String_format__table_vy2_525_jq} {#r_ScopedGlideDateTimeSetValueUTC_String_dt_String_format__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeSetValueUTC_String_dt_String_format__table_qpt_3f5_jq}  

    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.info(gdt.getValue());

출력:

    2011-02-15 08:00:00

## 범위가 지정된 GlideDateTime - setYearLocalTime(숫자 연도) {#ariaid-title63}

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

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

{#r_ScopedGlideDateTimeSetYearLocalTime_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeSetYearLocalTime_Number__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeSetYearLocalTime_Number__table_qpt_3f5_jq}  

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

출력:

    2013

## 범위가 지정된 GlideDateTime - setYearUTC(숫자 연도) {#ariaid-title64}

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

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

{#r_ScopedGlideDateTimeSetYearUTC_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeSetYearUTC_Number__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeSetYearUTC_Number__table_qpt_3f5_jq}  

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

출력:

    2013

## 범위가 지정된 GlideDateTime - 빼기(GlideTime 시간) {#ariaid-title65}

현재 GlideDateTime 객체에서 지정된 시간을 뺍니다.
{#r_ScopedGlideDateTimeSubtract_GlideTime__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideDateTimeSubtract_GlideTime__table_vy2_525_jq} {#r_ScopedGlideDateTimeSubtract_GlideTime__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeSubtract_GlideTime__table_qpt_3f5_jq}  

    var gdt = new GlideDateTime("2011-08-31 08:00:00");
    var gtime1 = new GlideTime();
    gtime1.setValue("00:00:20");
    gdt.subtract(gtime1);
    var gtime2 = gdt.getTime();
    gs.info(gtime2.getByFormat('hh:mm:ss'));

출력:

    07:59:40

## 범위가 지정된 GlideDateTime - 빼기(밀리초) {#ariaid-title66}

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

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

{#r_ScopedGlideDateTimeSubtract_Number__table_vy2_525_jq} {#r_ScopedGlideDateTimeSubtract_Number__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeSubtract_Number__table_qpt_3f5_jq}  

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

출력:

    2011-12-07 07:59:59

## 범위가 지정된 GlideDateTime - subtract(GlideDateTime start, GlideDateTime end) {#ariaid-title67}

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

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

{#r_ScopedGlideDateTimeSubtract_GlideDateTime_GlideDate_Time__table_vy2_525_jq} {#r_ScopedGlideDateTimeSubtract_GlideDateTime_GlideDate_Time__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeSubtract_GlideDateTime_GlideDate_Time__table_qpt_3f5_jq}  

    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); //the difference between gdt1 and gdt2
    gs.info(dur.getDisplayValue());

출력:

    2 Days 23 Hours

## 범위가 지정된 GlideDateTime - toString() {#ariaid-title68}

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

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

{#r_ScopedGlideDateTimeToString__table_vy2_525_jq} {#r_ScopedGlideDateTimeToString__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideDateTimeToString__table_qpt_3f5_jq}  

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

출력:

    2011-08-31 08:00:00


