GlideDate - 범위 지정됨

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

    • 범위가 지정된 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

    범위 지정 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

    범위 지정된 GlideDate - getDisplayValue()

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

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

    범위 지정된 GlideDate - getDisplayValueInternal()

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

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

    형식: yyyy-MM-dd

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

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

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

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

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

    출력:

    5

    범위 지정된 GlideDate - getValue()

    내부 형식(yyyy-MM-dd)과 시스템 표준 시간대(기본적으로 UTC)의 날짜를 가져옵니다.

    표 14. 매개변수
    이름 유형 설명
    없음
    표 15. 반환
    유형 설명
    문자열 시스템 시간대에 있는 GlideDate 객체의 날짜 값입니다.

    형식: yyyy-MM-dd

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

    범위 지정 GlideDate - getYearNoTZ()

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

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

    출력:

    2016

    범위 지정된 GlideDate - setDisplayValue(표시된 문자열)

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

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

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

    출력:

    2011-01-01

    범위 지정된 GlideDate - setDisplayValueLang(문자열 날짜, 문자열 스타일)

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

    표 20. 매개변수
    이름 유형 설명
    날짜 문자열 현재 사용자의 시간대에 있는 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의 기본값은 중간입니다. 허용되는 값은 대소문자를 구분하지 않습니다.
    표 21. 반환
    유형 설명
    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(문자열 날짜, 문자열 스타일, 문자열 언어)

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

    표 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의 기본값은 중간입니다. 허용되는 값은 대소문자를 구분하지 않습니다.
    언어 문자열 BCP-47 표준을 준수하는 언어 태그를 사용하여 언어를 설정합니다. 예를 들어 프랑스어의 경우 fr , 영국 영어의 경우 en-UK 입니다. 허용되는 값의 전체 목록은 BCP 47 언어 코드 목록을 참조하세요.
    표 23. 반환
    유형 설명
    무효

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

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

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

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

    출력:

    2015-01-01

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

    두 GlideDate 값 간의 기간 차이를 가져옵니다.

    표 26. 매개변수
    이름 유형 설명
    시작 GlideDate 시작 값입니다.
    끝 GlideDate 종료 값입니다.
    표 27. 반환
    유형 설명
    GlideDuration (글라이드 기간) 두 값 사이의 기간입니다. 
    var sgd1 = new GlideDate(); 
sgd1.setDisplayValue('2014-07-18'); 
var sgd2 = new GlideDate(); 
sgd2.setDisplayValue('2014-07-19'); 
 
var duration = GlideDate.subtract(sgd1, sgd2); 
gs.info(duration.getDisplayValue());
    출력: 
    1 Day