GlideDate - 전역

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

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

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

    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(String format)을 사용합니다.

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

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

    표 6. 매개변수
    이름 유형 설명
    없음
    표 7. 반환
    유형 설명
    문자열 현재 사용자의 표시 형식 및 시간대로 나타낸 GlideDate 객체의 날짜 값입니다. 비즈니스 규칙 또는 스크립트 포함을 디자인할 때는 이 메서드가 사용자마다 다른 형식으로 값을 반환할 수 있다는 점에 유의하십시오. 
    var gd = new GlideDate(); 
gd.setValue('2021-04-21');
gs.info(gd.getDisplayValue());
    출력: 
    2021-04-21

    범위가 지정된 등가

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

    GlideDate - getDisplayValueInternal()

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

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

    형식: yyyy-MM-dd

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

    범위가 지정된 등가

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

    GlideDate - getDisplayValueLang(문자열 스타일)

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

    표 10. 매개변수
    이름 유형 설명
    스타일 문자열 날짜 형식입니다.
    유효한 값은 다음과 같습니다.
    • 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의 기본값은 중간입니다. 허용되는 값은 대소문자를 구분하지 않습니다.
    표 11. 반환
    유형 설명
    문자열 지정된 스타일과 현재 사용자의 로캘에 적합한 형식으로 날짜를 나타내는 문자열입니다.

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

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

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

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

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

    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 표준 시간대로 가져옵니다.

    표 14. 매개변수
    이름 유형 설명
    없음
    표 15. 반환
    유형 설명
    번호 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 표준 시간대로 가져옵니다.

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

    출력:

    2016

    범위가 지정된 등가

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

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

    전달된 언어 및 국가 코드와 연결된 로케일로 날짜를 구문 분석합니다.

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

    형식:

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

    이 메서드는 날짜를 구문 분석하지 못한 경우 예외를 throw합니다. 날짜 형식이 지정된 로캘 형식(전달 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(String asDisplayed)

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

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

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

    출력:

    2011-01-01

    범위가 지정된 등가

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

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

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

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

    예를 들어 이 항목의 앞부분에 있는 getDisplayValueLang(String style, String language) 예제의 출력을 사용하면 2022년 10월 25일 또는 2022년 10월 25 일이 허용되는 값입니다.
    스타일 문자열 날짜 형식입니다.
    유효한 값은 다음과 같습니다.
    • 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의 기본값은 중간입니다. 허용되는 값은 대소문자를 구분하지 않습니다.
    표 23. 반환
    유형 설명
    void

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

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

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

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

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

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

    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)로 설정합니다.

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

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

    출력:

    2015-01-01

    범위가 지정된 등가

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