GlideDate - 범위 지정됨

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

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

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

    참고 항목 범위가 지정된 GlideDate - getDisplayValueInternal()

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

    형식: yyyy-MM-dd

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

    범위가 지정된 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의 기본값은 중간입니다. 수락된 값은 대/소문자를 구분하지 않습니다.
    언어 문자열 지정된 언어 값에 따라 날짜를 반환합니다. 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

    범위가 지정된 GlideDate - getValue()

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

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

    형식: yyyy-MM-dd

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

    범위가 지정된 GlideDate - getYearNoTZ()

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

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

    출력:

    2016

    범위가 지정된 GlideDate - setDisplayValue(문자열 asDisplayed)

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

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

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

    출력:

    2011-01-01

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

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

    표 22. 매개변수
    이름 유형 설명
    날짜 문자열 날짜에 대해 설정할 값입니다.
    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일 화요일
    표 23. 반환
    유형 설명
    없음

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

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

    출력:

    Wednesday, January 28, 2026

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

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

    표 24. 매개변수
    이름 유형 설명
    날짜 문자열 현재 사용자의 시간대에서 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의 기본값은 중간입니다. 수락된 값은 대/소문자를 구분하지 않습니다.
    표 25. 반환
    유형 설명
    무효

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

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

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

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

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

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

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

    출력:

    2015-01-01

    범위가 지정된 GlideDate - subtract(GlideDate start, GlideDate end)

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

    표 30. 매개변수
    이름 유형 설명
    시작 GlideDate 시작 값입니다.
    끝 GlideDate 종료 값입니다.
    표 31. 반환
    유형 설명
    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