GlideDate - 범위 지정됨

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 소요 시간: 11분

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

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

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

    참조: getDisplayValueInternal()

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

    범위가 지정된 GlideDate - getDisplayValueInternal()

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

    getDisplayValue()도 참조하십시오.

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

    형식: yyyy-MM-dd

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

    범위가 지정된 GlideDate - getDisplayValueLang(문자열 스타일, 문자열 언어)

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

    표 10. 매개변수
    이름 유형 설명
    스타일 문자열 날짜 형식입니다.
    유효한 값:
    • 전체: 사용자의 로캘(예: 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의 기본값은 중간입니다. 수락된 값은 대/소문자를 구분하지 않습니다.
    language 문자열 지정된 언어 값에 따라 날짜를 반환합니다. 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(문자열 asDisplayed)

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

    표 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(문자열 스타일, 문자열 언어) 예제의 출력을 사용하면 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의 기본값은 중간입니다. 수락된 값은 대/소문자를 구분하지 않습니다.
    표 21. 반환
    유형 설명
    무효

    다음 예시에서는 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(문자열 날짜, 문자열 스타일, 문자열 언어)

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

    표 22. 매개변수
    이름 유형 설명
    날짜 문자열 현재 사용자의 시간대에서 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의 기본값은 중간입니다. 수락된 값은 대/소문자를 구분하지 않습니다.
    language 문자열 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(String 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 - subtract(GlideDate start, GlideDate end)

    두 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