GlideDate - 전역

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 17분

    • GlideDate 클래스는 GlideDate 객체 인스턴스화 또는 GlideDate 필드 작업과 같은 GlideDate 객체에 대한 작업을 수행하기 위한 메서드를 제공합니다.

    일반적인 형식 충돌 목록이 있는 날짜 시간 입력 문자열에 대한 지침은 다음 문서를 날짜 및 시간 형식 지침참조하십시오.

    GlideDateTime - 전역 또한 참조하십시오.

    GlideDate - GlideDate()

    현재 날짜 시간을 사용하여 GlideDate 객체를 작성합니다.

    표 1. 매개변수
    이름 유형 설명
    없음 
    //Today's date is April 21, 2021
var gd = new GlideDate();
gs.info(gd.getValue());
    출력: 
    2021-04-21

    GlideDate - getByFormat(문자열 형식)

    지정된 날짜 형식으로 날짜를 가져옵니다.

    표 2. 매개변수
    이름 유형 설명
    format 문자열 Java SimpleDateFormat을 사용하는 원하는 날짜 형식입니다. 예를 들어, 일, 월 및 연도를 가져오려면 "dd-MM-yyyy" 를 가져오고, 요일을 가져오려면 "EEEE" 입니다.
    표 3. 반환
    유형 설명
    문자열 지정된 형식의 GlideDate 객체에 대한 날짜 값입니다. 
    var gd = new GlideDate(); 
gd.setValue('2021-04-21');
gs.info(gd.getByFormat("dd-MM-yyyy"));
    출력: 
    21-04-2021

    범위가 지정된 해당 항목

    범위가 지정된 애플리케이션에서 이 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 Scoped GlideDate - getByFormat(문자열 형식)을 사용합니다.

    GlideDate - getDayOfMonthNoTZ()

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

    표 4. 매개변수
    이름 유형 설명
    안 함
    표 5. 반환
    유형 설명
    번호 UTC 시간대의 일(1에서 31까지)입니다. 
    //Today's date is 2016-05-13 
var gd =new GlideDate();
gs.info(gd.getDayOfMonthNoTZ());

    출력:

    13

    범위가 지정된 해당 항목

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

    GlideDate - getDisplayValue ()

    UTC 시간대의 날짜 및 시간 필드 값을 가져옵니다.

    참조: 범위가 지정된 GlideDate - getDisplayValue()

    표 6. 매개변수
    이름 유형 설명
    없음
    표 7. 반환
    유형 설명
    문자열 UTC 시간대의 GlideDate 객체에 대한 날짜 값입니다. 
    var gd = new GlideDate(); 
gd.setValue('2025-04-21');
gs.info(gd.getDisplayValue());
    출력: 
    2025-04-21

    범위가 지정된 해당 항목

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

    GlideDate - getDisplayValueEx(문자열 스타일)

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

    표 8. 매개변수
    이름 유형 설명
    스타일 문자열 날짜에 사용할 형식입니다.
    유효한 값(대/소문자 구분 안 함):
    • 짧게: 현재 사용자의 언어에 따라 M/D/YY 또는 D/M/YY. 예를 들어 1/27/26 또는 27/1/26입니다.
    • medium: 약어로 된 월, 일, 연도입니다. 예: 2026년 1월 27일.
    • long: 월, 일, 연도입니다. 예: 2026년 1월 27일.
    • full: 요일, 월, 일 및 연도입니다. 예: 2026년 1월 27일 화요일

    날짜는 현재 사용자의 언어로 반환됩니다. 언어는 날짜의 월과 일의 순서를 결정합니다.
    표 9. 반환
    유형 설명
    문자열 지정된 형식의 날짜입니다.

    이 예에서는 현재 사용자의 시간대와 각 서식 옵션을 사용하여 날짜를 반환합니다.

    var gd = new GlideDate();
gs.info(gd.getDisplayValueEx("short"));
gs.info(gd.getDisplayValueEx("medium"));
gs.info(gd.getDisplayValueEx("long"));
gs.info(gd.getDisplayValueEx("full"));

    출력:

    1/27/26  //short
Jan 27, 2026  //medium
January 27, 2026  //long
Tuesday, January 27, 2026  //full

    범위가 지정된 해당 항목

    범위가 지정된 애플리케이션에서 이 메서드를 사용하려면 해당하는 범위가 지정된 메서드를 사용합니다. 범위가 지정된 GlideDate - getDisplayValueEx(문자열 스타일)

    GlideDate - getDisplayValueInternal()

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

    getDisplayValue () 도 참조하십시오.

    표 10. 매개변수
    이름 유형 설명
    없음
    표 11. 반환
    유형 설명
    문자열 현재 사용자의 시간대에서 GlideDate 객체의 날짜 값입니다.

    형식: yyyy-MM-dd

    		 
    var gd = new GlideDate(); 
gs.info(gd.getDisplayValueInternal());
    출력: 
    2021-04-21

    범위가 지정된 해당 항목

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

    GlideDate - getDisplayValueLang(문자열 스타일)

    지정된 날짜 스타일에 따라 사용자의 로케일에서 날짜 값을 반환합니다.

    표 12. 매개변수
    이름 유형 설명
    스타일 문자열 날짜 형식입니다.
    유효한 값은 다음과 같습니다.
    • 전체: 사용자의 로캘(예: 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의 기본값은 중간입니다. 수락된 값은 대/소문자를 구분하지 않습니다.
    표 13. 반환
    유형 설명
    문자열 현재 사용자의 로케일에 적합한 형식과 지정된 스타일로 날짜를 문자열로 표현한 것입니다.

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

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


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

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

    출력:

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

    GlideDate - getDisplayValueLang(문자열 스타일, 문자열 언어)

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

    표 14. 매개변수
    이름 유형 설명
    스타일 문자열 날짜 형식입니다.
    유효한 값은 다음과 같습니다.
    • 전체: 사용자의 로캘(예: 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의 기본값은 중간입니다. 수락된 값은 대/소문자를 구분하지 않습니다.
    언어 문자열 지정된 언어 값에 따라 날짜를 반환합니다. BCP-47 표준을 준수하는 언어 태그를 허용합니다. 예를 들어 프랑스어의 경우 fr , 영국 영어의 경우 en-UK 입니다. 허용되는 값의 전체 목록은 BCP 47 언어 코드 목록을 참조하세요.
    표 15. 반환
    유형 설명
    문자열 현재 사용자의 로케일에 따라 지정된 스타일 및 언어의 날짜입니다.

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

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


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

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

    출력:

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

    GlideDate - getMonthNoTZ()

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

    표 16. 매개변수
    이름 유형 설명
    안 함
    표 17. 반환
    유형 설명
    번호 1에서 12까지의 월의 숫자 값입니다. 
    //Today's date is 2016-05-13
var gd =new GlideDate();
gs.info(gd.getMonthNoTZ());

    출력:

    5

    범위가 지정된 해당 항목

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

    GlideDate - getYearNoTZ()

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

    표 18. 매개변수
    이름 유형 설명
    안 함
    표 19. 반환
    유형 설명
    번호 연도의 숫자 값입니다. 
    //Today's date is 2016-05-13
var gd =new GlideDate();
gs.info(gd.getYearNoTZ());

    출력:

    2016

    범위가 지정된 해당 항목

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

    GlideDate - parseDate(문자열 날짜, 문자열 언어, 문자열 국가)

    전달된 언어 및 국가 코드와 관련된 로캘로 날짜를 구문 분석합니다.

    주:
    이 메서드는 실패하고 지역 날짜 형식을 따르지 않으면 예외가 발생합니다.
    표 20. 매개변수
    이름 유형 설명
    날짜 문자열 지역 구문으로 형식화된 날짜입니다.

    형식:

    • 영숫자 날짜: 월을 Jan, Feb 또는 Mar과 같은 세 글자로 지정하거나 월의 이름을 완전히 철자할 수 있습니다. 연도는 4자리이고 일은 2자리여야 합니다. 예: "2020년 1월 31일" 또는 "2020년 1월 31일"
    • 숫자 날짜: 일과 월은 2자리여야 합니다. 4자리 숫자는 수년 동안 매우 선호되지만 이 방법은 정확도가 떨어지고 구문 분석 실패 가능성이 높은 2자리 연도를 지원합니다. 또한 지역 날짜 구분 기호를 사용해야 합니다. 이러한 구분 기호는 전달 language 된 값과 country 값에 따라 구문 분석에 영향을 줍니다. 예: 미국 로캘의 경우 "12/31/2020", 에스토니아 로캘의 경우 "31.12.20"입니다.
    언어 문자열 ISO-639 두 글자 언어 코드.
    국가 문자열 ISO-3166 두 문자로 된 국가 코드입니다.
    표 21. 반환
    유형 설명
    객체 계산에 사용하거나 기록에 삽입할 수 있는 구문 분석된 GlideDate 객체입니다.

    이 메서드는 날짜를 구문 분석하지 못하면 예외를 발생시킵니다. 날짜 형식이 지정된 로케일 형식(전달 language 된 및 country 매개변수)과 일치하지 않으면 예외가 발생합니다.

    다음 코드 예제에서는 날짜를 구문 분석하고 해당 날짜에 4주를 추가합니다.

    var date = GlideDate.parseDate("31 Dec 2020", "en", "GB");
date.addWeeksLocalTime(4);
gs.info("Project is due 4 weeks after start date, on " + date.getDisplayValue());

    출력:

    Project is due 4 weeks after start date, on 2021-01-28

    GlideDate - setDisplayValue(문자열 asDisplayed)

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

    표 22. 매개변수
    이름 유형 설명
    asDisplayed 문자열 현재 사용자의 표시 형식과 시간대의 날짜입니다.

    형식: 현재 사용자가 선호하는 표시 형식(예: yyyy-MM-dd)을 사용하여 형식을 지정해야 합니다.
    표 23. 반환
    유형 설명
    없음 
    var gd = new GlideDate();
gd.setDisplayValue("2011-01-01");
gs.info(gd.getValue());

    출력:

    2011-01-01

    범위가 지정된 해당 항목

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

    GlideDate - setDisplayValueEx(문자열 날짜, 문자열 스타일)

    지정된 형식을 사용하여 날짜를 설정합니다.

    표 24. 매개변수
    이름 유형 설명
    날짜 문자열 날짜에 대해 설정할 값입니다.
    getDisplayValueEx() 메서드는 유효한 형식으로 날짜를 반환하거나 아래와 같이 날짜 형식을 지정할 수 있습니다.
    • 현재 사용자의 언어에 따라 M/D/YY 또는 D/M/YY. 예를 들어 1/27/26 또는 27/1/26입니다.
    • 약어로 된 월, 일, 연도입니다. 예: 2026년 1월 27일.
    • 월, 일, 연도입니다. 예: 2026년 1월 27일.
    • 요일, 월, 일, 연도입니다. 예: 2026년 1월 27일 화요일
    현재 사용자의 언어에 따라 날짜에서 허용되는 월과 일의 순서가 결정됩니다. 예를 들어 현재 사용자의 언어가 영어인 경우 2026년 3월 21 일 및 2026년 3월 21 일은 유효한 값이지만 2026년 3월 21 일 및 21일 은 유효하지 않습니다.
    스타일 문자열 날짜에 사용할 형식입니다.

    제공된 date 값과 동일한 형식을 사용해야 합니다.

    유효한 값(대/소문자 구분 안 함):
    • 짧게: 현재 사용자의 언어에 따라 M/D/YY 또는 D/M/YY. 예를 들어 1/27/26 또는 27/1/26입니다.
    • medium: 약어로 된 월, 일, 연도입니다. 예: 2026년 1월 27일.
    • long: 월, 일, 연도입니다. 예: 2026년 1월 27일.
    • full: 요일, 월, 일 및 연도입니다. 예: 2026년 1월 27일 화요일
    표 25. 반환
    유형 설명
    없음

    이 예에서는 지정된 형식을 사용하여 날짜를 설정합니다.

    gd = new GlideDate();
gd.setDisplayValueEx("Jan 28, 2026", "medium");
gs.info(gd.getDisplayValueEx("full"));

    출력:

    Wednesday, January 28, 2026

    범위가 지정된 해당 항목

    범위가 지정된 애플리케이션에서 이 메서드를 사용하려면 해당하는 범위가 지정된 메서드를 사용합니다. 범위가 지정된 GlideDate - setDisplayValueEx(문자열 날짜, 문자열 스타일)

    GlideDate - setDisplayValueLang(문자열 날짜, 문자열 스타일)

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

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

    예를 들어 이 주제 앞부분의 getDisplayValueLang(문자열 스타일, 문자열 언어) 예제의 출력을 사용하면 2022년 10월 25일 또는 2022년10월 25 일이 허용되는 값입니다.
    스타일 문자열 날짜 형식입니다.
    유효한 값은 다음과 같습니다.
    • 전체: 사용자의 로캘(예: 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의 기본값은 중간입니다. 수락된 값은 대/소문자를 구분하지 않습니다.
    표 27. 반환
    유형 설명
    무효

    다음 예시에서는 setDisplayValueLang()을 사용하여 사용자 로케일의 현재 날짜를 '전체' 스타일로 설정하는 방법을 보여줍니다.

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


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

    출력:

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

    GlideDate - setDisplayValueLang(문자열 날짜, 문자열 스타일, 문자열 언어)

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

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

    예를 들어 이 주제 앞부분의 getDisplayValueLang(문자열 스타일, 문자열 언어) 예제의 출력을 사용하면 2022년 10월 25일 또는 2022년10월 25 일이 허용되는 값입니다.
    스타일 문자열 날짜 형식입니다.
    유효한 값은 다음과 같습니다.
    • 전체: 사용자의 로캘(예: 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의 기본값은 중간입니다. 수락된 값은 대/소문자를 구분하지 않습니다.
    언어 문자열 BCP-47 표준을 준수하는 언어 태그를 사용하여 언어를 설정합니다. 예를 들어 프랑스어의 경우 fr , 영국 영어의 경우 en-UK 입니다. 허용되는 값의 전체 목록은 BCP 47 언어 코드 목록을 참조하세요.
    표 29. 반환
    유형 설명
    무효

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

    var glideDateFR = new GlideDate(); 

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

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

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

    출력:

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

    GlideDate - setValue(문자열 o)

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

    표 30. 매개변수
    이름 유형 설명
    o 문자열 현재 GlideDate 객체에서 설정할 날짜 및 시간입니다.

    형식: yyyy-MM-dd
    표 31. 반환
    유형 설명
    없음 
    var gd = new GlideDate(); 
gd.setValue('2015-01-01');
gs.info(gd.getValue());

    출력:

    2015-01-01

    범위가 지정된 해당 항목

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