GlideDate - 범위 지정됨

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기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()

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

    표 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일 월요일)에 따라 <weekday, month, day 및 year> 형식으로 날짜를 반환합니다.
    • Long: 사용자의 로캘(예: 2022년 10월 24일)에 따라 <월, 일, 연도> 형식으로 날짜를 반환합니다.
    • medium: long 과 유사하지만 축약된 월이 포함된 날짜를 반환합니다(예: 2022년 10월 24일).
    • short: 사용자의 로캘에 따라 MM/DD/YY 또는 DD/MM/YY 형식으로 날짜를 반환합니다(예: 2022/10/24 또는 2022/10/24).

    다른 값이 전달되면 API의 기본값은 medium으로 설정됩니다. 수락된 값은 대소문자를 구분하지 않습니다.
    언어 문자열 지정된 언어 값에 따라 날짜를 반환합니다. 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()

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

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

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

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

    출력:

    2016

    범위가 지정된 GlideDate - setDisplayValue(String asDisplayed)

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

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

    형식: 현재 사용자가 선호하는 표시 형식(예: 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일 월요일)에 따라 <weekday, month, day 및 year> 형식으로 날짜를 반환합니다.
    • Long: 사용자의 로캘(예: 2022년 10월 24일)에 따라 <월, 일, 연도> 형식으로 날짜를 반환합니다.
    • medium: long 과 유사하지만 축약된 월이 포함된 날짜를 반환합니다(예: 2022년 10월 24일).
    • short: 사용자의 로캘에 따라 MM/DD/YY 또는 DD/MM/YY 형식으로 날짜를 반환합니다(예: 2022/10/24 또는 2022/10/24).

    다른 값이 전달되면 API의 기본값은 medium으로 설정됩니다. 수락된 값은 대소문자를 구분하지 않습니다.
    표 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일 월요일)에 따라 <weekday, month, day 및 year> 형식으로 날짜를 반환합니다.
    • Long: 사용자의 로캘(예: 2022년 10월 24일)에 따라 <월, 일, 연도> 형식으로 날짜를 반환합니다.
    • medium: long 과 유사하지만 축약된 월이 포함된 날짜를 반환합니다(예: 2022년 10월 24일).
    • short: 사용자의 로캘에 따라 MM/DD/YY 또는 DD/MM/YY 형식으로 날짜를 반환합니다(예: 2022/10/24 또는 2022/10/24).

    다른 값이 전달되면 API의 기본값은 medium으로 설정됩니다. 수락된 값은 대소문자를 구분하지 않습니다.
    언어 문자열 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)

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

    표 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