GlideDateTime - 전역

GlideDateTime - GlideDateTime()

현재 날짜 및 시간으로 새 GlideDateTime 객체를 인스턴스화합니다.

표 1. 매개변수
이름	유형	설명
안 함

이 예제에서는 GlideDateTime 개체를 인스턴스화합니다.

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

출력:

2022-08-08 16:51:44

GlideDateTime - GlideDateTime(문자열 날짜/시간)

전달된 날짜 및 시간 값을 사용하여 새 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

주:

다음 형식은 지원되지 않습니다.

yyyy-MM-dd'T'HH:mm:ss입니다. SSSZ

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

이 예제에서는 문자열을 사용하여 GlideDateTime 개체를 인스턴스화하는 방법을 보여 줍니다.

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

출력:

2023-01-01 12:00:00

GlideDateTime - GlideDateTime(GlideDateTime gdt)

지정된 GlideDateTime 개체의 시간으로 설정된 새 GlideDateTime 개체를 인스턴스화합니다.

표 3. 매개변수
이름	유형	설명
증권 시세 표시기	Glide날짜/시간	새 객체의 시간을 설정하는 데 사용되는 객체입니다.

이 예제에서는 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(숫자, 밀리초)

GlideDateTime 객체에 지정된 시간(밀리초)을 추가합니다.

표 4. 매개변수
이름	유형	설명
밀리초	번호	더할 시간(밀리초)

표 5. 반환
유형	설명
void

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

출력:

1314777600000
1314777600010

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 add() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 add()를 사용합니다.

GlideDateTime - add(GlideTime 시간)

현재 GlideDateTime 객체에 GlideTime 객체를 추가합니다.

표 6. 매개변수
이름	유형	설명
시간	글라이드타임	지정된 GlideDateTime 객체에 추가할 시간 값이 있는 GlideTime 객체입니다.

표 7. 반환
유형	설명
void

이 예제에서는 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

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 add() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 add()를 사용합니다.

GlideDateTime - addDays(일수)

현재 GlideDateTime 객체에 지정된 일 수를 추가합니다. 음수 매개변수는 일수를 뺍니다.

이 메서드 대신 addDaysLocalTime() 및 addDaysUTC() 를 사용합니다.

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

표 9. 반환
유형	설명
void

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

출력:

2011-08-30

GlideDateTime - addDaysLocalTime(일수)

현재 GlideDateTime 객체에 지정된 일 수를 추가합니다. 음수 매개변수는 일수를 뺍니다.

메서드는 GlideDateTime 개체에 저장된 값에 해당하는 현지 날짜 및 시간을 결정한 다음 현지 날짜 및 시간 값을 사용하여 일을 더하거나 뺍니다.

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

표 11. 반환
유형	설명
void

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

출력:

2011-08-30

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 addDaysLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 addDaysLocalTime()을 사용합니다.

GlideDateTime - addDaysUTC(일수)

현재 GlideDateTime 객체에 지정된 일 수를 추가합니다. 음수 매개변수는 일수를 뺍니다.

메서드는 GlideDateTime 개체에 저장된 값에 해당하는 UTC 날짜 및 시간을 결정한 다음, UTC 날짜 및 시간 값을 사용하여 일을 더하거나 뺍니다.

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

표 13. 반환
유형	설명
void

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

출력:

2011-08-30

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 addDaysUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 addDaysUTC()를 사용합니다.

GlideDateTime - addSeconds(수, 초)

GlideDateTime 객체에 지정된 시간(초)을 추가합니다.

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

표 15. 반환
유형	설명
void

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

출력:

2011-12-07 08:16:40

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 addSeconds() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 addSeconds()를 사용합니다.

GlideDateTime - addWeeks(숫자, 주)

현재 GlideDateTime 객체에 지정된 주 수를 추가합니다. 음수 매개변수는 주를 뺍니다.

이 메서드 대신 addWeeksLocalTime() 및 addWeeksUTC() 를 사용합니다.

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

표 17. 반환
유형	설명
void

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

출력:

2011-08-24

GlideDateTime - addWeeksLocalTime(주 수)

현재 GlideDateTime 객체에 지정된 주 수를 추가합니다. 음수 매개변수는 주를 뺍니다.

메서드는 GlideDateTime 개체에 저장된 값에 해당하는 현지 날짜 및 시간을 결정한 다음, 현지 날짜 및 시간 값을 사용하여 주를 더하거나 뺍니다.

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

표 19. 반환
유형	설명
void

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

출력:

2011-08-24

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 addWeeksLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 addWeeksLocalTime()을 사용합니다.

GlideDateTime - addWeeksUTC(주 수)

현재 GlideDateTime 객체에 지정된 주 수를 추가합니다. 음수 매개변수는 주를 뺍니다.

메서드는 GlideDateTime 개체에 저장된 값에 해당하는 UTC 날짜 및 시간을 결정한 다음 UTC 날짜 및 시간 값을 사용하여 주를 더하거나 뺍니다.

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

표 21. 반환
유형	설명
void

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

출력:

2011-08-24

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 addWeeksUTC() 메서드를 사용하려면 해당하는 범위가 지정된 addWeeksUTC() 메서드를 사용합니다.

GlideDateTime - addMonths(월 수)

현재 GlideDateTime 객체에 지정된 개월 수를 추가합니다. 음수 매개변수는 월을 뺍니다.

이 메서드 대신 addMonthsLocalTime() 또는 addMonthsUTC() 를 사용하십시오.

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

표 23. 반환
유형	설명
void

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

출력:

2011-10-31

GlideDateTime - addMonthsLocalTime(월 수)

현재 GlideDateTime 객체에 지정된 개월 수를 추가합니다. 음수 매개변수는 월을 뺍니다.

메서드는 GlideDateTime 개체에 저장된 값에 해당하는 현지 날짜 및 시간을 결정한 다음 현지 날짜 및 시간 값을 사용하여 월을 더하거나 뺍니다.

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

표 25. 반환
유형	설명
void

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

출력:

2011-10-31

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 addMonthsLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 addMonthsLocalTime()을 사용합니다.

GlideDateTime - addMonthsUTC(월 수)

현재 GlideDateTime 객체에 지정된 개월 수를 추가합니다. 음수 매개변수는 월을 뺍니다.

메서드는 GlideDateTime 개체에 저장된 값에 해당하는 UTC 날짜 및 시간을 결정한 다음 UTC 날짜 및 시간 값을 사용하여 월을 더하거나 뺍니다.

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

표 27. 반환
유형	설명
void

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

출력:

2011-10-31

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 addMonthsUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 addMonthsUTC()를 사용합니다.

GlideDateTime - addYears(연도 수)

현재 GlideDateTime 객체에 지정된 연도를 추가합니다. 음수 매개변수는 연도를 뺍니다.

이 메서드 대신 addYearsLocalTime() 또는 addYearsUTC() 를 사용합니다.

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

표 29. 반환
유형	설명
void

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

출력:

2011-08-31

GlideDateTime - addYearsLocalTime(연도 수)

현재 GlideDateTime 객체에 지정된 연도를 추가합니다. 음수 매개변수는 연도를 뺍니다.

메서드는 GlideDateTime 개체에 저장된 값에 해당하는 현지 날짜 및 시간을 결정한 다음 현지 날짜 및 시간 값을 사용하여 연도를 더하거나 뺍니다.

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

표 31. 반환
유형	설명
void

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

출력:

2011-08-31

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 AddYearsLocalTime() 메서드를 사용하려면 해당 범위가 지정된 메서드인 AddYearsLocalTime()을 사용합니다.

GlideDateTime - addYearsUTC(연도 수)

현재 GlideDateTime 객체에 지정된 연도를 추가합니다. 음수 매개변수는 연도를 뺍니다.

GlideDateTime 객체에 의해 저장된 날짜 및 시간 값은 UTC 시간대에 있는 것으로 해석됩니다.

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

표 33. 반환
유형	설명
void

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

출력:

2011-08-31

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 addYearsUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 addYearsUTC()를 사용합니다.

GlideDateTime - compareTo(객체 날짜/시간)

두 날짜 및 시간 객체를 비교하여 둘 중 하나가 다른 개체보다 먼저 발생하는지 또는 동일한지 확인합니다.

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

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

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

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 compareTo() 메서드를 사용하려면 해당 범위가 지정된 메서드인 compareTo()를 사용합니다.

GlideDateTime - 같음(객체 GDT)

동일성을 위해 객체를 기존 값과 비교합니다.

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

표 37. 반환
유형	설명
부울	같으면 True, 그렇지 않으면 False입니다.

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

출력:

 false

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 equals() 메서드를 사용하려면 해당 범위가 지정된 메서드인 equals()를 사용합니다.

GlideDateTime - getDate()

GlideDateTime 객체에 저장된 날짜를 반환합니다. yyyy-MM-dd 형식으로 표시되며 시스템 시간대(기본값)는 UTC입니다.

표 38. 매개변수
이름	유형	설명
없음

표 39. 반환
유형	설명
문자열	시스템 시간대의 날짜입니다. 형식: yyyy-MM-dd, 시스템 시간대에서는 기본적으로 UTC입니다.

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

출력:

2011-08-31

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 getDate() 메서드를 사용하려면 해당하는 범위가 지정된 메서드 getDate()를 사용합니다.

GlideDateTime - getDayOfMonth()

UTC 시간대로 월의 현재 날짜를 가져옵니다.

사용되지 않습니다. 이 메서드 대신 getDayOfMonthLocalTime() 및 getDayOfMonthUTC() 를 사용합니다.

표 40. 매개변수
이름	유형	설명
없음

표 41. 반환
유형	설명
번호	UTC 시간대의 일(월 중)로, 1에서 31 사이입니다.

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

출력:

GlideDateTime - getDayOfMonthLocalTime()

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

표 42. 매개변수
이름	유형	설명
없음

표 43. 반환
유형	설명
번호	사용자 시간대의 일(월 중)로, 1에서 31 사이입니다.

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

출력:

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 getDayOfMonthLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 getDayOfMonthLocalTime()을 사용합니다.

GlideDateTime - getDayOfMonthUTC()

UTC 표준 시간대로 표현된 GlideDateTime 객체에 저장된 일(월 중)을 가져옵니다.

표 44. 매개변수
이름	유형	설명
없음

표 45. 반환
유형	설명
번호	UTC 시간대의 일(월 중)로, 1에서 31 사이입니다.

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

출력:

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 getDayOfMonthUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 getDayOfMonthUTC()를 사용합니다.

GlideDateTime - getDayOfWeek()

사용자의 시간대로 표현된 GlideDateTime 객체에 의해 저장된 요일을 검색합니다.

이 메서드 대신 getDayOfWeekLocalTime() 및 getDayOfWeekUTC() 를 사용하십시오.

표 46. 매개변수
이름	유형	설명
없음

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

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

출력:

GlideDateTime - getDayOfWeekLocalTime()

사용자의 시간대로 표현된 GlideDateTime 개체에 저장된 요일을 가져옵니다.

표 48. 매개변수
이름	유형	설명
없음

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

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

출력:

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 getDayOfWeekLocalTime() 메서드를 사용하려면 해당 범위가 지정된 메서드인 getDayOfWeekLocalTime()을 사용합니다.

GlideDateTime - getDayOfWeekUTC()

UTC 표준 시간대로 표현된 GlideDateTime 객체에 저장된 요일을 가져옵니다.

표 50. 매개변수
이름	유형	설명
없음

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

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

출력:

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 getDayOfWeekUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 getDayOfWeekUTC()를 사용합니다.

GlideDateTime - getDaysInMonth()

GlideDateTime 객체에 의해 저장된 월의 일 수를 가져옵니다(Java Virtual Machine 시간대로 표현됨).

이 메서드 대신 getDaysInMonthLocalTime() 및 getDaysInMonthUTC() 를 사용합니다.

표 52. 매개변수
이름	유형	설명
없음

표 53. 반환
유형	설명
번호	Java Virtual Machine 시간대의 현재 월의 일 수입니다.

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

출력:

GlideDateTime - getDaysInMonthLocalTime()

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

표 54. 매개변수
이름	유형	설명
없음

표 55. 반환
유형	설명
번호	사용자의 시간대로 표시된 이번 달의 일 수입니다.

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

출력:

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 getDaysInMonthLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 getDaysInMonthLocalTime()을 사용합니다.

GlideDateTime - getDaysInMonthUTC()

UTC 시간대로 표현된 GlideDateTime 객체에 저장된 월의 일 수를 가져옵니다.

표 56. 매개변수
이름	유형	설명
없음

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

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

출력:

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 getDaysInMonthUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 getDaysInMonthUTC()를 사용합니다.

GlideDateTime - getDisplayValue()

현재 사용자의 표시 형식과 시간대로 날짜 및 시간 값을 가져옵니다.

주:

GlideDateTime 개체를 참조하면 GMT 표준 시간대의 날짜 및 시간 값이 직접 반환됩니다.

표 58. 매개변수
이름	유형	설명
없음

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

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

출력:

2011-08-31 01:00:00

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 getDisplayValue() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 getDisplayValue()를 사용합니다.

GlideDateTime - getDisplayValueInternal ()

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

표 60. 매개변수
이름	유형	설명
없음

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

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

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 getDisplayValueInternal() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 getDisplayValueInternal()을 사용합니다.

GlideDateTime - getDisplayValueLang(문자열 스타일)

지정된 날짜 스타일에 따라 현재 사용자의 로캘에서 날짜 및 시간 값을 반환합니다.

표 62. 매개변수
이름	유형	설명
스타일	문자열	날짜 및 시간 형식을 지정합니다. 유효한 값은 다음과 같습니다. full: 사용자의 로캘(예: 2022년 10월 24일 월요일)에 따라 <weekday, month, day 및 year> 형식으로 날짜를 반환합니다. Long: 사용자의 로캘(예: 2022년 10월 24일)에 따라 <월, 일, 연도> 형식으로 날짜를 반환합니다. medium: long 과 유사하지만 축약된 월이 포함된 날짜를 반환합니다(예: 2022년 10월 24일). short: 사용자의 로캘에 따라 MM/DD/YY 또는 DD/MM/YY 형식으로 날짜를 반환합니다(예: 2022/10/24 또는 2022/10/24). 다른 값이 전달되면 API는 기본적으로 `medium`을 사용합니다. 수락된 값은 대소문자를 구분하지 않습니다.

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

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

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(문자열 스타일, 문자열 언어)

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

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

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

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

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

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

표 66. 매개변수
이름	유형	설명
없음

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

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

출력:

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 getDSTOffset() 메서드를 사용하려면 해당 범위가 지정된 메서드 getDSTOffset()을 사용합니다.

GlideDateTime - getErrorMsg()

현재 오류 메시지를 가져옵니다.

표 68. 매개변수
이름	유형	설명
없음

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

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

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 getErrorMsg() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 getErrorMsg()를 사용합니다.

GlideDateTime - getInternalFormattedLocalTime()

객체의 시간을 현지 시간대와 내부 형식으로 반환합니다.

표 70. 매개변수
이름	유형	설명
없음

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

이 예제에서는 사용자 표준 시간대의 시스템 시간 형식으로 시간을 표시합니다.

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

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 getInternalFormattedLocalTime() 메서드를 사용하려면 해당 범위가 지정된 메서드인 getInternalFormattedLocalTime()을 사용합니다.

GlideDateTime - getInternalMidnight(Number, dayOfTheWeek)

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

표 72. 매개변수
이름	유형	설명
요일	번호	날짜/시간 객체를 반환할 요일입니다.

표 73. 반환
유형	설명
Glide날짜/시간	자정으로 설정된 GlideDateTime 객체입니다.

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

출력:

2011-08-30 00:00:01

GlideDateTime - getLocalDate()

GlideDateTime 객체에 의해 저장된 날짜를 표준 형식(yyyy-MM-dd 및 현재 사용자의 시간대로 표현됨)으로 가져옵니다.

표 74. 매개변수
이름	유형	설명
없음

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

이 예제에서는 사용자의 표준 시간대에 사용자의 시간 형식으로 시간을 표시합니다.

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

출력:

2011-08-31

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 getLocalDate() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 getLocalDate()를 사용합니다.

GlideDateTime - getLocalTime()

사용자의 시간대로 시간을 가져옵니다.

표 76. 매개변수
이름	유형	설명
없음

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

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

출력:

1970-01-01 01:00:00

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 getLocalTime() 메서드를 사용하려면 해당 범위가 지정된 메서드인 getLocalTime()을 사용합니다.

GlideDateTime - getMonth()

GlideDateTime 객체에 의해 저장된 월을 조회하며, Java 가상 머신 시간대로 표현됩니다.

이 메서드 대신 getMonthLocalTime() 및 getMonthUTC() 를 사용하십시오.

표 78. 매개변수
이름	유형	설명
없음

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

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

출력:

GlideDateTime - getMonthLocalTime()

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

표 80. 매개변수
이름	유형	설명
없음

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

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

출력:

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 getMonthLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 getMonthLocalTime()을 사용합니다.

GlideDateTime - getMonthUTC()

UTC 표준 시간대로 표현된 GlideDateTime 개체에 저장된 월을 가져옵니다.

표 82. 매개변수
이름	유형	설명
없음

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

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

출력:

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 getMonthUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드 getMonthUTC()를 사용합니다.

GlideDateTime - getNumericValue()

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

표 84. 매개변수
이름	유형	설명
없음

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

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

출력:

1314777600000

GlideDateTime - getSpanTime(Number, dayOfWeek)

지정된 날의 자정부터 현재 시간까지 경과된 시간을 조회합니다.

표 86. 매개변수
이름	유형	설명
요일	번호	1에서 7 사이의 요일 값입니다. 1 = 월요일, 7=일요일.

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

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

Unix 기간 스탬프를 가져옵니다.

표 88. 매개변수
이름	유형	설명
없음

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

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

출력:

1970-01-01 08:00:00

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 getTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 getTime()을 사용합니다.

GlideDateTime - getTZOffset()

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

표 90. 매개변수
이름	유형	설명
없음

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

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

출력:

-28800000

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 getTZOffset() 메서드를 사용하려면 해당 범위가 지정된 메서드 getTZOffset()을 사용합니다.

GlideDateTime - getUserFormattedLocalTime()

사용자 형식의 로컬 시간대로 객체의 시간을 반환합니다.

표 92. 매개변수
이름	유형	설명
없음

표 93. 반환
유형	설명
객체	객체의 현지 시간 및 사용자 형식입니다.

다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

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

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 getUserFormattedLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 getUserFormattedLocalTime()을 사용합니다.

GlideDateTime - getUserTimeZone()

현재 사용자 세션의 시간대를 검색합니다.

이 메서드는 gs.getSession().getTimeZone()과 동일합니다.

표 94. 매개변수
이름	유형	설명
없음

표 95. 반환
유형	설명
TimeZone	현재 사용자의 TimeZone 객체입니다.

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)

UTC 시간대를 사용하여 시간이 자정으로 설정된 GlideDateTime 객체를 검색합니다.

이 메서드는 새 GlideDateTime 개체의 날짜를 원래 GlideDateTime 개체의 주 내에서 지정된 요일로 설정합니다.

표 96. 매개변수
이름	유형	설명
요일	번호	요일, 1에서 7까지. 월요일=1, 일요일=7. 이 매개변수에 0을 입력하지 마십시오.

표 97. 반환
유형	설명
Glide날짜/시간	자정으로 설정된 새 GlideDateTime 객체입니다.

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

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

표 98. 매개변수
이름	유형	설명
없음

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

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

출력:

2011-08-31 08:00:00

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 getValue() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 getValue()를 사용합니다.

GlideDateTime - getWeekOfYearLocalTime()

현재 사용자의 시간대로 표현된 GlideDateTime 객체에 저장된 주의 수를 가져옵니다.

모든 주는 일요일에 시작한다. 연도의 첫 번째 주는 새해의 적어도 하루가 포함된 주입니다. 2015-12-27 일요일로 시작하는 주는 해당 주에 1월 1일과 2일이 포함되므로 2016년 첫 번째 주로 간주됩니다.

표 100. 매개변수
이름	유형	설명
없음

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

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

출력:

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 getWeekOfYearLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 getWeekOfYearLocalTime()을 사용합니다.

GlideDateTime - getWeekOfYearUTC()

UTC 표준 시간대로 표현된 GlideDateTime 개체에 저장된 주 수를 가져옵니다.

모든 주는 일요일에 시작한다. 연도의 첫 번째 주는 새해의 적어도 하루가 포함된 주입니다. 2015-12-27 일요일로 시작하는 주는 해당 주에 1월 1일과 2일이 포함되므로 2016년 첫 번째 주로 간주됩니다.

표 102. 매개변수
이름	유형	설명
없음

표 103. 반환
유형	설명
번호	UTC 시간 기준 현재 주의 수입니다. 1년 중 가장 높은 주 번호는 52 또는 53입니다.

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

출력:

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 getWeekOfYearUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드 getWeekOfYearUTC()를 사용합니다.

GlideDateTime - getYear()

GlideDateTime 객체에 의해 저장된 연도를 조회하며, Java Virtual Machine 시간대로 표현됩니다.

이 메서드 대신 getYearLocalTime() 및 getYearUTC() 를 사용합니다.

표 104. 매개변수
이름	유형	설명
없음

표 105. 반환
유형	설명
번호	JVM(Java Virtual Machine) 시간대의 4자리 연도 값입니다.

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

출력:

GlideDateTime - getYearLocalTime()

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

표 106. 매개변수
이름	유형	설명
없음

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

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

출력:

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 getYearLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 getYearLocalTime()을 사용합니다.

GlideDateTime - getYearUTC()

GlideDateTime 객체에서 저장한 연도를 UTC 표준 시간대로 표현하여 반환합니다.

표 108. 매개변수
이름	유형	설명
없음

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

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

출력:

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 getYearUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드 getYearUTC()를 사용합니다.

GlideDateTime - hasDate()

객체의 날짜를 설정할지 여부를 결정합니다.

표 110. 매개변수
이름	유형	설명
없음

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

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

출력:

true

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 hasDate() 메서드를 사용하려면 해당 범위가 지정된 메서드인 hasDate()를 사용합니다.

GlideDateTime - isDST()

객체의 시간이 일광 절약 시간제를 사용하는지 여부를 결정합니다.

표 112. 매개변수
이름	유형	설명
없음

표 113. 반환
유형	설명
부울	시간이 일광 절약 시간제이면 True이고 그렇지 않으면 False입니다.

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

출력:

true

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 isDST() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 isDST()를 사용합니다.

GlideDateTime - isValid()

값이 유효한 날짜 및 시간인지 확인합니다.

표 114. 매개변수
이름	유형	설명
없음

표 115. 반환
유형	설명
부울	값이 유효하면 True, 그렇지 않으면 False입니다.

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

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 isValid() 메서드를 사용하려면 해당 범위가 지정된 메서드인 isValid()를 사용합니다.

GlideDateTime - setDayOfMonth(숫자, 일)

월의 일을 지정된 값으로 설정합니다.

이 메서드 대신 setDayOfMonthLocalTime(day) 및 setDayOfMonthUTC(day)를 사용합니다.

표 116. 매개변수
이름	유형	설명
일	번호	1에서 31 사이의 날짜입니다.

표 117. 반환
유형	설명
void

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

출력:

GlideDateTime - setDayOfMonthLocalTime(숫자, 일)

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

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

표 119. 반환
유형	설명
void

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

출력:

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 setDayOfMonthLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 setDayOfMonthLocalTime()을 사용합니다.

GlideDateTime - setDayOfMonthUTC(숫자, 일)

일자를 UTC 시간대의 지정된 값으로 설정합니다.

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

표 121. 반환
유형	설명
void

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

출력:

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 setDayOfMonthUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드 setDayOfMonthUTC()를 사용합니다.

GlideDateTime - setDisplayValue(String asDisplayed)

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

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

표 123. 반환
유형	설명
void

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

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 setDisplayValue() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 setDisplayValue()를 사용합니다.

GlideDateTime - setDisplayValue(문자열, 날짜/시간, 문자열 형식)

현재 사용자의 시간대와 지정된 날짜 및 시간 형식을 사용하여 날짜 및 시간 값을 설정합니다.

이 메서드는 dateTime 매개 변수에 사용된 날짜 및 시간 형식이 format 매개 변수와 일치하지 않으면 런타임 예외를 throw합니다. 예외가 catch된 후 GlideDateTime 객체에서 getErrorMsg() 를 호출하여 오류 메시지를 검색할 수 있습니다.

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

표 125. 반환
유형	설명
void

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

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 setDisplayValue() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 setDisplayValue()를 사용합니다.

GlideDateTime - setDisplayValueInternal(문자열 날짜/시간)

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

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

표 127. 반환
유형	설명
void

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

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 setDisplayValueInternal() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 setDisplayValueInternal()을 사용합니다.

GlideDateTime - setDisplayValueInternalWithAlternates(문자열 날짜/시간)

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

이 메서드는 불완전한 날짜 및 시간 값을 구문 분석하려고 시도합니다.

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

표 129. 반환
유형	설명
void

GlideDateTime - setDisplayValueLang(문자열, 날짜/시간, 문자열, 스타일)

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

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

표 131. 반환
유형	설명
무효

다음 예에서는 짧은 스타일과 전체 스타일로 날짜 및 시간을 반환합니다.

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(문자열 날짜/시간, 문자열 스타일, 문자열 언어)

현재 사용자의 로캘에 따라 지정된 스타일, 언어 및 형식을 사용하여 날짜 및 시간을 설정합니다.

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

표 133. 반환
유형	설명
무효

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

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)

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

이 메서드는 GlideDateTime 매개 변수를 사용하여 새 개체를 인스턴스화하는 것과 같습니다.

표 134. 매개변수
이름	유형	설명
gDT	Glide날짜/시간	GlideDateTime 객체

표 135. 반환
유형	설명
void

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

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 setGlideDateTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 setGlideDateTime()을 사용합니다.

GlideDateTime - setInitialValue(문자열 날짜/시간)

날짜 및 시간을 설정합니다.

이 메서드는 setValue(Object)와 동일합니다.

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

표 137. 반환
유형	설명
void

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

출력:

2011-01-01 12:00:00

GlideDateTime - setMonth(월, 숫자)

GlideDateTime 객체에서 저장한 월을 Java Virtual Machine 시간대를 사용하여 지정된 값으로 설정합니다.

이 메서드 대신 setMonthLocalTime() 또는 setMonthUTC() 를 사용합니다.

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

표 139. 반환
유형	설명
void

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

출력:

GlideDateTime - setMonthLocalTime(월 수)

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

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

표 141. 반환
유형	설명
void

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

출력:

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 setMonthLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 setMonthLocalTime()을 사용합니다.

GlideDateTime - setMonthUTC(월 수)

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

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

표 143. 반환
유형	설명
void

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

출력:

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 setMonthUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드 setMonthUTC()를 사용합니다.

GlideDateTime - setNumericValue(숫자, 밀리초)

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

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

표 145. 반환
유형	설명
void

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

출력:

2011-08-31 08:00:00

GlideDateTime - setTZ(시간대 시간대)

GlideDateTime 개체의 표준 시간대를 지정된 표준 시간대로 설정합니다.

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

표 147. 반환
유형	설명
void

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

GlideDateTime - setValue(객체 날짜/시간)

GlideDateTime 객체의 날짜 및 시간을 설정합니다.

이 메서드는 setInitialValue()와 동일합니다.

표 148. 매개변수
이름	유형	설명
날짜/시간	객체	사용할 날짜 및 시간입니다. 이 매개변수는 여러 유형 중 하나일 수 있습니다. 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 Date 개체를 허용하지 않습니다. JavaScript 번호: 숫자 값을 사용하여 객체의 값을 1970년 1월 1일 00:00:00 UTC를 지난 밀리초로 설정합니다. 이 방법을 사용하는 것은 setNumericValue(밀리초) 메서드와 동일합니다. Java Integer 또는 Long: Integer 또는 Long 값을 사용하여 객체의 값을 1970년 1월 1일 00:00:00 UTC를 지난 밀리초로 설정합니다. 이 방법을 사용하는 것은 setNumericValue(밀리초) 메서드와 동일합니다.

표 149. 반환
유형	설명
void

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

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 setValue() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 setValue()를 사용합니다.

GlideDateTime - setValueUTC(문자열, 날짜/시간, 문자열, 형식)

UTC 시간대와 지정된 날짜 및 시간 형식을 사용하여 날짜 및 시간 값을 설정합니다.

이 메서드는 dateTime 매개 변수에 사용된 날짜 및 시간 형식이 format 매개 변수와 일치하지 않으면 런타임 예외를 throw합니다. 예외가 catch된 후 GlideDateTime 객체에서 getErrorMsg() 를 호출하여 오류 메시지를 검색할 수 있습니다.

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

표 151. 반환
유형	설명
void

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

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 setValueUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 setValueUTC()를 사용합니다.

GlideDateTime - setYear(숫자, 연도)

GlideDateTime 객체에서 저장한 연도를 Java Virtual Machine 시간대를 사용하여 지정된 값으로 설정합니다.

이 메서드 대신 setYearLocalTime() 또는 setYearUTC() 를 사용하십시오.

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

표 153. 반환
유형	설명
void

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

출력:

GlideDateTime - setYearLocalTime(숫자 연도)

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

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

표 155. 반환
유형	설명
void

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

출력:

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 setYearLocalTime() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 setYearLocalTime()을 사용합니다.

GlideDateTime - setYearUTC(숫자 연도)

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

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

표 157. 반환
유형	설명
void

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

출력:

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 setYearUTC() 메서드를 사용하려면 해당하는 범위가 지정된 메서드 setYearUTC()를 사용합니다.

GlideDateTime - 빼기(GlideTime 시간)

지정된 시간을 뺍니다.

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

표 159. 반환
유형	설명
void

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

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 subtract() 메서드를 사용하려면 해당 범위가 지정된 메서드인 subtract()를 사용합니다.

GlideDateTime - 빼기(밀리초 수)

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

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

표 161. 반환
유형	설명
void

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

출력:

2011-12-07 07:59:59

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 subtract() 메서드를 사용하려면 해당 범위가 지정된 메서드인 subtract()를 사용합니다.

GlideDateTime - 빼기(GlideDateTime 시작, GlideDateTime 종료)

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

표 162. 매개변수
이름	유형	설명
시작	Glide날짜/시간	시작 날짜 객체입니다.
끝	Glide날짜/시간	종료 날짜 객체입니다.

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

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

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 subtract() 메서드를 사용하려면 해당 범위가 지정된 메서드인 subtract()를 사용합니다.

GlideDateTime - toString()

GlideDateTime 객체에 저장된 날짜 및 시간 값을 내부 형식(yyyy-MM-dd HH:mm:ss) 및 시스템 시간대(기본적으로 UTC)로 반환합니다.

이 메서드는 getValue()와 동일합니다.

표 164. 매개변수
이름	유형	설명
없음

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

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

출력:

2011-08-31 08:00:00

범위가 지정된 해당 항목

범위가 지정된 응용 프로그램에서 toString() 메서드를 사용하려면 해당 범위가 지정된 메서드인 toString()을 사용합니다.