GlideDateTime - 범위 지정됨

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기44분

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

    GlideDateTime 메서드를 사용하여 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입니다. 증권 시세 표시기
    표 2. 매개변수
    이름 유형 설명
    값 문자열 GlideDateTime 개체에서 설정할 UTC 날짜 및 시간입니다. 
    var gdt = new GlideDateTime("2023-01-01 12:00:00");
gs.info(gdt);

    출력:

    2023-01-01 12:00:00

    범위 지정된 GlideDateTime - GlideDateTime(GlideDateTime g)

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

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

    이 예제에서는 yyyy-MM-dd'T'HH:mm:ss를 사용하여 GlideDateTime 개체를 인스턴스화합니다. SSSZ 형식입니다.

    var gdt1 = new GlideDateTime("2023-07-04T12:08:56.235-0700");
var gdt2 = new GlideDateTime(gdt1);
gs.info(gdt1);
gs.info(gdt2);

    출력:

    2023-07-04 19:08:56
2023-07-04 19:08:56

    범위 지정된 GlideDateTime - add(GlideTime gd)

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

    표 4. 매개변수
    이름 유형 설명
    gd 글라이드 타임 지정된 GlideDateTime 객체에 시간 값을 추가할 GlideTime 객체입니다.
    표 5. 반환
    유형 설명
    없음 
    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(밀리초 수)

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

    표 6. 매개변수
    이름 유형 설명
    밀리초 번호 더할 시간(밀리초)입니다.
    표 7. 반환
    유형 설명
    없음 
    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(일수)

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

    표 8. 매개변수
    이름 유형 설명
    일 번호 추가할 일 수입니다. 음수 값을 사용하여 뺍니다.
    표 9. 반환
    유형 설명
    없음 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addDaysLocalTime(-1);
gs.info(gdt.getLocalDate());

    출력:

    2011-08-30

    범위 지정된 GlideDateTime - addDaysUTC(일)

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

    표 10. 매개변수
    이름 유형 설명
    일 번호 추가할 일 수입니다. 음수를 사용하여 뺍니다.
    표 11. 반환
    유형 설명
    없음 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addDaysUTC(-1);
gs.info(gdt.getDate());

    출력:

     2011-08-30

    범위 지정 GlideDateTime - addMonthsLocalTime(개월 수)

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

    표 12. 매개변수
    이름 유형 설명
    월 번호 더할 개월 수입니다. 음수 값을 사용하여 뺍니다.
    표 13. 반환
    유형 설명
    없음 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addMonthsLocalTime(2);
gs.info(gdt.getDate());

    출력:

    2011-10-31

    범위 지정된 GlideDateTime - addMonthsUTC(개월 수)

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

    표 14. 매개변수
    이름 유형 설명
    월 번호 추가할 개월 수입니다. 음수 값을 사용하여 뺍니다.
    표 15. 반환
    유형 설명
    없음 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addMonthsUTC(2);
gs.info(gdt.getDate());

    출력:

    2011-10-31

    범위 지정된 GlideDateTime - addSeconds(초, 숫자)

    현재 GlideDateTime 객체에 지정된 시간(초)을 더합니다.

    표 16. 매개변수
    이름 유형 설명
    초 번호 더할 시간(초)입니다.
    표 17. 반환
    유형 설명
    없음 
    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(주 수)

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

    표 18. 매개변수
    이름 유형 설명
    주 번호 추가할 주 수입니다. 음수 값을 사용하여 뺍니다.
    표 19. 반환
    유형 설명
    없음 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addWeeksLocalTime(-1);
gs.info(gdt.getDate());

    출력:

    2011-08-24

    범위 지정 GlideDateTime - addWeeksUTC(주 수)

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

    표 20. 매개변수
    이름 유형 설명
    주 번호 추가할 주 수입니다. 음수 값을 사용하여 뺍니다.
    표 21. 반환
    유형 설명
    없음 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addWeeksUTC(-1);
gs.info(gdt.getDate());

    출력:

    2011-08-24

    범위 지정된 GlideDateTime - addYearsLocalTime(연도 수)

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

    표 22. 매개변수
    이름 유형 설명
    년 번호 더할 연도 수입니다. 음수 값을 사용하여 뺍니다.
    표 23. 반환
    유형 설명
    없음 
    var gdt = new GlideDateTime("2010-08-31 08:00:00");
gdt.addYearsLocalTime(1);
gs.info(gdt.getDate());

    출력:

    2011-08-31

    범위 지정된 GlideDateTime - addYearsUTC(연도 수)

    현재 GlideDateTime 객체에 지정된 연도를 더합니다. 음수 매개변수는 연도를 뺍니다. GlideDateTime 개체에 의해 저장된 날짜 및 시간 값은 UTC 표준 시간대로 해석됩니다.

    표 24. 매개변수
    이름 유형 설명
    년 번호 더할 연도 수입니다. 음수 값을 사용하여 뺍니다.
    표 25. 반환
    유형 설명
    없음 
    var gdt = new GlideDateTime("2010-08-31 08:00:00");
gdt.addYearsUTC(1);
gs.info(gdt.getDate());

    출력:

    2011-08-31

    범위 지정된 GlideDateTime - after(GlideDateTime gdt)

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

    표 26. 매개변수
    이름 유형 설명
    증권 시세 표시기 GlideDateTime 확인할 날짜 및 시간입니다.
    표 27. 반환
    유형 설명
    부울 GlideDateTime 개체의 날짜 및 시간이 매개 변수로 지정된 날짜 및 시간 이후인지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: GlideDateTime 객체 날짜 및 시간은 지정된 객체의 날짜 및 시간 이후입니다.
    • false: GlideDateTime 객체 날짜 및 시간이 지정된 객체의 날짜 및 시간 이전이거나 같습니다.
    		 
    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 - before(GlideDateTime gdt)

    GlideDateTime 객체의 날짜 및 시간이 지정된 GlideDateTime 객체의 날짜 및 시간 이전인지 여부를 결정합니다.

    표 28. 매개변수
    이름 유형 설명
    증권 시세 표시기 GlideDateTime 확인할 날짜 및 시간입니다.
    표 29. 반환
    유형 설명
    부울 GlideDateTime 개체의 날짜 및 시간이 매개 변수로 지정된 날짜 및 시간 이전인지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: GlideDateTime 객체 날짜 및 시간이 지정된 날짜 및 시간 앞에 있습니다.
    • 아니오: GlideDateTime 객체 날짜 및 시간이 지정된 날짜 및 시간 이후이거나 같습니다.
    		 
    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(객체 o)

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

    표 30. 매개변수
    이름 유형 설명
    o 객체 GlideDateTime 형식의 날짜 및 시간 객체
    표 31. 반환
    유형 설명
    번호
    • 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

    범위 지정된 GlideDateTime - equals(객체 dateTime)

    datetime과 기존 값이 같은지 비교합니다.

    표 32. 매개변수
    이름 유형 설명
    날짜/시간 GlideDateTime 객체 또는 문자열 비교할 날짜/시간입니다.
    표 33. 반환
    유형 설명
    부울 같으면 true를 반환합니다. 그렇지 않으면 false입니다. 
    var gdt = new GlideDateTime("2011-08-31 00:00:00");
gs.info(gdt.equals("2011-09-30 00:12:01"));

    출력:

    false

    범위 지정된 GlideDateTime - getDate()

    GlideDateTime 개체에 의해 저장된 날짜를 반환합니다. 표준 형식(yyyy-MM-dd)과 시스템 표준 시간대(GMT)로 기본 표시됩니다.

    표 34. 매개변수
    이름 유형 설명
    없음
    표 35. 반환
    유형 설명
    객체 시스템 시간대의 날짜입니다. 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getDate());

    출력:

    2011-08-31

    범위 지정 GlideDateTime - getDayOfMonthLocalTime()

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

    표 36. 매개변수
    이름 유형 설명
    없음
    표 37. 반환
    유형 설명
    번호 사용자의 시간대에 해당하는 날짜(1에서 31 사이)입니다. 
    var gdt = new GlideDateTime("2011-12-02 12:00:00");
gs.info(gdt.getDayOfMonthLocalTime());

    출력:

    2

    범위 지정 GlideDateTime - getDayOfMonthUTC()

    GlideDateTime 개체에 의해 저장된 날짜를 UTC 표준 시간대로 표현 가져옵니다.

    표 38. 매개변수
    이름 유형 설명
    없음
    표 39. 반환
    유형 설명
    번호 UTC 시간대의 날짜(1에서 31까지)입니다. 
    var gdt = new GlideDateTime("2011-12-02 12:00:00");
gs.info(gdt.getDayOfMonthUTC());

    출력:

    02

    범위 지정 GlideDateTime - getDayOfWeekLocalTime()

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

    표 40. 매개변수
    이름 유형 설명
    없음
    표 41. 반환
    유형 설명
    번호 사용자의 시간대에서 1에서 7까지의 요일 값입니다. 월요일은 1, 일요일은 7과 같습니다. 
    var gdt = new GlideDateTime("2011-12-01 12:00:00");//Thursday
gs.info(gdt.getDayOfWeekLocalTime());

    출력:

    4

    범위 지정 GlideDateTime - getDayOfWeekUTC()

    GlideDateTime 개체에 의해 저장된 요일을 UTC 표준 시간대로 반환합니다.

    표 42. 매개변수
    이름 유형 설명
    없음
    표 43. 반환
    유형 설명
    번호 1에서 7까지의 요일 값입니다. 월요일은 1, 일요일은 7과 같습니다. 
    var gdt = new GlideDateTime("2011-12-01 12:00:00"); //Thursday
gs.info(gdt.getDayOfWeekUTC());

    출력:

    4

    범위 지정 GlideDateTime - getDaysInMonthLocalTime()

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

    표 44. 매개변수
    이름 유형 설명
    없음
    표 45. 반환
    유형 설명
    번호 사용자의 시간대에 있는 현재 월의 일 수입니다. 
    var gdt = new GlideDateTime("2011-12-02 12:00:00"); //December
gs.info(gdt.getDaysInMonthLocalTime());

    출력:

    30

    범위 지정 GlideDateTime - getDaysInMonthUTC()

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

    표 46. 매개변수
    이름 유형 설명
    없음
    표 47. 반환
    유형 설명
    번호 GlideDateTime 개체에 의해 저장된 월의 일 수로, UTC 표준 시간대로 표현됩니다. 
    var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
gs.info(gdt.getDaysInMonthUTC());

    출력:

    30

    범위 지정된 GlideDateTime - getDisplayValue()

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

    표 48. 매개변수
    이름 유형 설명
    없음
    표 49. 반환
    유형 설명
    문자열 사용자의 형식 및 시간대의 날짜 및 시간입니다. 비즈니스 규칙 또는 스크립트 포함을 디자인할 때는 이 메서드가 사용자마다 다른 형식으로 값을 반환할 수 있다는 점에 유의하십시오. 
    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()

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

    표 50. 매개변수
    이름 유형 설명
    없음
    표 51. 반환
    유형 설명
    문자열 현재 사용자의 시간대에 있는 GlideDateTime 객체의 날짜 및 시간 값과 내부 날짜 및 시간 형식인 yyyy-MM-dd HH:mm:ss입니다. 
    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(문자열 스타일, 문자열 언어)

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

    표 52. 매개변수
    이름 유형 설명
    스타일 문자열 날짜 및 시간 형식을 지정합니다.
    유효한 값은 다음과 같습니다.
    • full: 사용자의 로캘에 따라 <요일, 월, 일, 연도> 형식으로 날짜를 반환합니다(예: 2022년 10월 24일 월요일).
    • long: 사용자의 로캘에 따라 <월, 일, 연도> 형식으로 날짜를 반환합니다(예: 2022년 10월 24일).
    • medium: long 과 유사하지만 축약된 월이 있는 날짜를 반환합니다(예: Oct 24, 2022).
    • short: 사용자의 로캘에 따라 MM/DD/YY 또는 DD/MM/YY 형식으로 날짜를 반환합니다(예: 2022/10/24 또는 2022/10/24).

    다른 값이 전달되면 API는 기본적으로 medium을 사용합니다. 허용되는 값은 대소문자를 구분하지 않습니다.
    언어 문자열 지정된 언어 값에 따라 날짜를 반환합니다. BCP-47 표준을 준수하는 언어 태그를 허용합니다. 예를 들어 프랑스어의 경우 fr , 영국 영어의 경우 en-UK 입니다. 허용되는 값의 전체 목록은 BCP 47 언어 코드 목록을 참조하세요.
    표 53. 반환
    유형 설명
    문자열 지정된 스타일과 현재 사용자의 로캘에 적합한 형식으로 날짜를 나타내는 문자열입니다.

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

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

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

    표 54. 매개변수
    이름 유형 설명
    없음
    표 55. 반환
    유형 설명
    번호 일광 절약 시간제가 오프셋되는 시간(밀리초)입니다. 오프셋이 없거나 시간이 일광 절약 시간제 중이 아닌 경우 0을 반환합니다. 
    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()

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

    표 56. 매개변수
    이름 유형 설명
    없음
    표 57. 반환
    유형 설명
    객체 오류 메시지입니다. 
    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()

    로컬 시간대 및 내부 형식으로 객체의 시간을 반환합니다.

    표 58. 매개변수
    이름 유형 설명
    없음
    표 59. 반환
    유형 설명
    문자열 로컬 표준 시간대의 객체 시간과 내부 형식입니다.

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

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

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

    표 60. 매개변수
    이름 유형 설명
    없음
    표 61. 반환
    유형
    GlideDate 사용자의 시간대에 있는 날짜입니다. 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getLocalDate());

    출력:

    2011-08-31

    범위 지정된 GlideDateTime - getLocalTime()

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

    표 62. 매개변수
    이름 유형 설명
    없음
    표 63. 반환
    유형 설명
    글라이드 타임 사용자의 시간대로 표시된 시간입니다. 
    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()

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

    표 64. 매개변수
    이름 유형 설명
    없음
    표 65. 반환
    유형 설명
    번호 월의 숫자 값입니다. 
    var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
gs.info(gdt.getMonthLocalTime());

    출력:

    11

    범위 지정 GlideDateTime - getMonthUTC()

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

    표 66. 매개변수
    이름 유형 설명
    없음
    표 67. 반환
    유형 설명
    번호 월의 숫자 값입니다. 
    var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
gs.info(gdt.getMonthUTC());

    출력:

    11

    범위 지정된 GlideDateTime - getNumericValue()

    1970년 1월 1일 00:00:00 GMT 이후의 시간(밀리초)을 가져옵니다.

    표 68. 매개변수
    이름 유형 설명
    없음
    표 69. 반환
    유형 설명
    번호 1970년 1월 1일 00:00:00 GMT 이후의 시간(밀리초)입니다. 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getNumericValue());

    출력:

    1314777600000

    범위 지정 GlideDateTime - getTime()

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

    표 70. 매개변수
    이름 유형 설명
    없음
    표 71. 반환
    유형 설명
    글라이드 타임 GMT 시간을 기준으로 하는 시스템 형식의 Unix 기간 스탬프입니다. 
    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()

    시간대 오프셋을 밀리초 단위로 가져옵니다.

    표 72. 매개변수
    이름 유형 설명
    없음
    표 73. 반환
    유형 설명
    번호 시간대 오프셋의 밀리초 수입니다. 
    var gdt = new GlideDateTime();
gdt.getLocalTime(); // PST local time
gs.info(gdt.getTZOffset());

    출력:

    -25200000

    범위 지정 GlideDateTime - getUserFormattedLocalTime()

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

    표 74. 매개변수
    이름 유형 설명
    없음
    표 75. 반환
    유형 설명
    문자열 현지 시간대 및 사용자 형식의 객체 시간입니다.

    이 예제에서는 로컬 표준 시간대의 객체 시간을 보여 줍니다.

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

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

    표 76. 매개변수
    이름 유형 설명
    없음
    표 77. 반환
    유형 설명
    문자열 내부 형식 및 시스템 시간대의 날짜 및 시간입니다.

    형식: yyyy-MM-dd HH:mm:ss(UTC 표준 시간대)

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

    출력:

    2014-08-31 08:00:00

    범위 지정 GlideDateTime - getWeekOfYearLocalTime()

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

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

    표 78. 매개변수
    이름 유형 설명
    없음
    표 79. 반환
    유형 설명
    번호 현재 주의 번호입니다. 1년 중 가장 높은 주 수는 52 또는 53입니다. 
    var gdt = new GlideDateTime("2011-12-01 12:00:00");//49th week, 1st week in december 
gs.info(gdt.getWeekOfYearLocalTime());

    출력:

    49

    범위 지정 GlideDateTime - getWeekOfYearUTC()

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

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

    표 80. 매개변수
    이름 유형 설명
    없음
    표 81. 반환
    유형 설명
    번호 현재 주의 번호(UTC 시간)입니다. 1년 중 가장 높은 주 수는 52 또는 53입니다. 
    var gdt = new GlideDateTime("2011-12-01 12:00:00");//49th week, 1st week in December 
gs.info(gdt.getWeekOfYearUTC());

    출력:

    49

    범위 지정 GlideDateTime - getYearLocalTime()

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

    표 82. 매개변수
    이름 유형 설명
    없음
    표 83. 반환
    유형 설명
    번호 사용자의 시간대에 있는 4자리 연도 값입니다. 
    var gdt = new GlideDateTime("2011-11-02 12:00:00");
gs.info(gdt.getYearLocalTime());

    출력:

    2011

    범위 지정 GlideDateTime - getYearUTC()

    GlideDateTime 개체에 의해 저장된 연도를 UTC 표준 시간대로 표현 가져옵니다.

    표 84. 매개변수
    이름 유형 설명
    없음
    표 85. 반환
    유형 설명
    번호 UTC 시간대의 4자리 연도 값입니다. 
    var gdt = new GlideDateTime("2011-11-02 12:00:00"); 
gs.info(gdt.getYearUTC());

    출력:

    2011

    범위 지정된 GlideDateTime - hasDate()

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

    표 86. 매개변수
    이름 유형 설명
    없음
    표 87. 반환
    유형 설명
    부울 객체 날짜가 설정되면 True입니다. 그렇지 않으면 false를 반환합니다. 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.hasDate());

    출력:

    true

    범위 지정된 GlideDateTime - isDST()

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

    표 88. 매개변수
    이름 유형 설명
    없음
    표 89. 반환
    유형 설명
    부울 시간이 일광 절약 시간제인 경우 True입니다. 그렇지 않으면 false를 반환합니다. 
    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()

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

    표 90. 매개변수
    이름 유형 설명
    없음
    표 91. 반환
    유형 설명
    부울 값이 유효하면 예입니다. 그렇지 않으면 false를 반환합니다. 
    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)

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

    표 92. 매개변수
    이름 유형 설명
    증권 시세 표시기 GlideDateTime 확인할 날짜 및 시간입니다.
    표 93. 반환
    유형 설명
    부울 GlideDateTime 개체의 날짜 및 시간이 매개 변수로 지정된 날짜 및 시간과 같거나 나중인지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: GlideDateTime 객체 날짜 및 시간이 지정된 객체의 날짜 및 시간과 같거나 이후입니다.
    • 아니오: GlideDateTime 객체 날짜 및 시간이 지정된 객체의 날짜 및 시간 이전입니다.
    		 
    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)

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

    표 94. 매개변수
    이름 유형 설명
    증권 시세 표시기 GlideDateTime 확인할 날짜 및 시간입니다.
    표 95. 반환
    유형 설명
    부울 GlideDateTime 개체의 날짜 및 시간이 매개 변수로 지정된 날짜 및 시간과 같거나 이전인지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: GlideDateTime 객체 날짜 및 시간이 지정된 객체의 날짜 및 시간과 같거나 이전입니다.
    • 아니오: GlideDateTime 객체 날짜 및 시간이 지정된 객체의 날짜 및 시간 이후입니다.
    		 
    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(숫자, 일)

    날짜를 현재 사용자의 시간대에 지정된 값으로 설정합니다.

    표 96. 매개변수
    이름 유형 설명
    일 번호 변경할 월의 일(월 중 1에서 31까지)입니다. 이 값이 해당 월의 최대 일 수보다 크면 해당 월의 마지막 날로 설정됩니다.
    표 97. 반환
    유형 설명
    없음 
    var gdt = new GlideDateTime();
gdt.setDayOfMonthLocalTime(9);
gs.info(gdt.getDayOfMonthLocalTime());

    출력:

    9

    범위 지정된 GlideDateTime - setDayOfMonthUTC(숫자 일)

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

    표 98. 매개변수
    이름 유형 설명
    일 번호 변경할 월의 일(월 중 1에서 31까지)입니다. 이 값이 해당 월의 최대 일 수보다 크면 해당 월의 마지막 날로 설정됩니다.
    표 99. 반환
    유형 설명
    없음 
    var gdt = new GlideDateTime();
gdt.setDayOfMonthUTC(9);
gs.info(gdt.getDayOfMonthUTC());

    출력:

    9

    범위 지정된 GlideDateTime - setDisplayValue(String asDisplayed)

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

    표 100. 매개변수
    이름 유형 설명
    asDisplayed로 문자열 현재 사용자의 표시 형식과 시간대의 날짜 및 시간입니다. 매개변수는 현재 사용자가 선호하는 표시 형식(예: MM-dd-yyyy HH:mm:ss)을 사용하여 서식을 지정해야 합니다. 워크플로우 스크립트에서 변수에 현재 날짜 및 시간을 할당하려면 변수 .setDisplayValue(gs.nowDateTime);를 사용합니다.
    표 101. 반환
    유형 설명
    없음 
    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(문자열 값, 문자열 형식)

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

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

    표 102. 매개변수
    이름 유형 설명
    값 문자열 현재 사용자의 시간대에 있는 날짜 및 시간입니다.
    format 문자열 매개변수를 구문 분석하는 데 사용할 날짜 및 시간 형식입니다 value .
    다음 값을 사용하여 매개변수를 설명합니다.value
    • dd: 일(월 중)
    • MM: 연중 월
    • yyyy: 연도
    • HH: 시간
    • mm: 분
    • ss: 초

    예: "dd-MM-yyyy HH:mm:ss" 또는 "MM-dd-yyyy HH:mm".
    표 103. 반환
    유형 설명
    없음 
    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(문자열 값)

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

    표 104. 매개변수
    이름 유형 설명
    값 문자열 내부 형식의 날짜 및 시간입니다.
    표 105. 반환
    유형 설명
    없음 
    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(문자열, 날짜/시간, 문자열, 스타일)

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

    표 106. 매개변수
    이름 유형 설명
    날짜/시간 문자열 현재 사용자의 시간대에 있는 GlideDate 객체의 날짜 및 시간 값입니다. 유효한 값은 getDisplayValueLang() 함수에서 출력된 날짜 및 시간입니다.

    예를 들어 이 항목의 앞부분에 있는 getDisplayValueLang(String style, String language) 예제의 출력을 사용하여 2022년 11월 28일 07:03:41 또는 2022년11월 28일 07:03:41 이 허용되는 값입니다.
    스타일 문자열 날짜 형식을 지정합니다.
    유효한 값은 다음과 같습니다.
    • full: 사용자의 로캘에 따라 <요일, 월, 일, 연도> 형식으로 날짜를 반환합니다(예: 2022년 10월 24일 월요일).
    • long: 사용자의 로캘에 따라 <월, 일, 연도> 형식으로 날짜를 반환합니다(예: 2022년 10월 24일).
    • medium: long 과 유사하지만 축약된 월이 있는 날짜를 반환합니다(예: Oct 24, 2022).
    • short: 사용자의 로캘에 따라 MM/DD/YY 또는 DD/MM/YY 형식으로 날짜를 반환합니다(예: 2022/10/24 또는 2022/10/24).

    다른 값이 전달되면 API는 기본적으로 medium을 사용합니다. 허용되는 값은 대소문자를 구분하지 않습니다.
    표 107. 반환
    유형 설명
    무효

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

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

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

    표 108. 매개변수
    이름 유형 설명
    날짜/시간 문자열 현재 사용자의 시간대에 있는 GlideDate 객체의 날짜 및 시간 값입니다. 유효한 값은 getDisplayValueLang() 함수에서 출력된 날짜 및 시간입니다.

    예를 들어 이 항목의 앞부분에 있는 getDisplayValueLang(String style, String language) 예제의 출력을 사용하여 2022년 11월 28일 07:03:41 또는 2022년11월 28일 07:03:41 이 허용되는 값입니다.
    스타일 문자열 날짜 형식을 지정합니다.
    유효한 값은 다음과 같습니다.
    • full: 사용자의 로캘에 따라 <요일, 월, 일, 연도> 형식으로 날짜를 반환합니다(예: 2022년 10월 24일 월요일).
    • long: 사용자의 로캘에 따라 <월, 일, 연도> 형식으로 날짜를 반환합니다(예: 2022년 10월 24일).
    • medium: long 과 유사하지만 축약된 월이 있는 날짜를 반환합니다(예: Oct 24, 2022).
    • short: 사용자의 로캘에 따라 MM/DD/YY 또는 DD/MM/YY 형식으로 날짜를 반환합니다(예: 2022/10/24 또는 2022/10/24).

    다른 값이 전달되면 API는 기본적으로 medium을 사용합니다. 허용되는 값은 대소문자를 구분하지 않습니다.
    언어 문자열 BCP-47 표준을 준수하는 언어 태그를 사용하여 언어를 설정합니다. 예를 들어 프랑스어의 경우 fr , 영국 영어의 경우 en-UK 입니다. 허용되는 값의 전체 목록은 BCP 47 언어 코드 목록을 참조하세요.
    표 109. 반환
    유형 설명
    무효

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

    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)

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

    표 110. 매개변수
    이름 유형 설명
    g GlideDateTime datetime 값을 설정하는 데 사용할 객체입니다.
    표 111. 반환
    유형 설명
    없음 
    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(월 수)

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

    표 112. 매개변수
    이름 유형 설명
    월 번호 변경할 월입니다.
    표 113. 반환
    유형 설명
    없음 
    var gdt = new GlideDateTime();
gdt.setMonthLocalTime(1);
gs.info(gdt.getMonthLocalTime());

    출력:

    1

    범위 지정 GlideDateTime - setMonthUTC(숫자 월)

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

    표 114. 매개변수
    이름 유형 설명
    월 번호 변경할 월입니다.
    표 115. 반환
    유형 설명
    없음 
    var gdt = new GlideDateTime();
gdt.setMonthUTC(1);
gs.info(gdt.getMonthUTC());

    출력:

    1

    범위 지정된 GlideDateTime - setValue(문자열 o)

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

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

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

    표 118. 매개변수
    이름 유형 설명
    증권 시세 표시기 문자열 사용할 날짜 및 시간입니다.
    format 문자열 사용할 날짜 및 시간 형식입니다.
    표 119. 반환
    유형 설명
    없음 
    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(숫자 연도)

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

    표 120. 매개변수
    이름 유형 설명
    년 번호 변경할 연도입니다.
    표 121. 반환
    유형 설명
    없음 
    var gdt = new GlideDateTime();
gdt.setYearLocalTime(2013);
gs.info(gdt.getYearLocalTime());

    출력:

    2013

    범위 지정된 GlideDateTime - setYearUTC(숫자 연도)

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

    표 122. 매개변수
    이름 유형 설명
    년 번호 변경할 연도입니다.
    표 123. 반환
    유형 설명
    없음 
    var gdt = new GlideDateTime();
gdt.setYearUTC(2013);
gs.info(gdt.getYearUTC());

    출력:

    2013

    범위 지정된 GlideDateTime - 빼기(GlideTime 시간)

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

    표 124. 매개변수
    이름 유형 설명
    시간 글라이드 타임 뺄 시간 값입니다.
    표 125. 반환
    유형 설명
    없음 
    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 - 빼기(밀리초 수)

    GlideDateTime 객체에서 지정된 밀리초 수를 뺍니다.

    표 126. 매개변수
    이름 유형 설명
    밀리초 번호 뺄 시간(밀리초)입니다.
    표 127. 반환
    유형 설명
    없음 
    var gdt = new GlideDateTime("2011-12-07 08:00:00");
gdt.subtract(1000);
gs.info(gdt.getValue());

    출력:

    2011-12-07 07:59:59

    범위 지정된 GlideDateTime - 빼기(GlideDateTime 시작, GlideDateTime 종료)

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

    표 128. 매개변수
    이름 유형 설명
    시작 GlideDateTime 시작 날짜 객체입니다.
    종료 GlideDateTime 종료 날짜 객체입니다.
    표 129. 반환
    유형 설명
    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); //the difference between gdt1 and gdt2
gs.info(dur.getDisplayValue());

    출력:

    2 Days 23 Hours

    범위 지정된 GlideDateTime - toString()

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

    표 130. 매개변수
    이름 유형 설명
    없음
    표 131. 반환
    유형
    문자열 GlideDateTime 개체에 의해 시스템 표준 시간대 및 형식으로 저장된 날짜 및 시간입니다. 
    var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.toString());

    출력:

    2011-08-31 08:00:00