GlideTime - 범위 지정됨

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

    • GlideTime API에는 GlideTime 객체 인스턴스화 또는 GlideTime 필드 작업과 같은 GlideTime 객체에 대한 작업을 수행하는 메서드가 있습니다.

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

    GlideTime - GlideTime()

    현재 시간으로 GlideTime 객체를 인스턴스화합니다.

    표 1. 매개변수
    이름 유형 설명
    안 함 
    var gt = new GlideTime(); 
gs.info(gt.getDisplayValue());

    GlideTime - GlideTime(밀리초 수)

    자정(UTC)에 시작하는 시간에 전달된 값을 더한 GlideTime 객체를 인스턴스화합니다.

    이 값은 인스턴스가 있는 시간대에 맞게 조정됩니다. 예를 들어 사용자의 인스턴스가 UTC에서 -8시간 떨어진 시간대에 있고 1000이 전달되면 GlideTime 객체의 시간은 16:00:10(00:00:00 - 8시간 +10초)입니다.

    표 2. 매개변수
    이름 유형 설명
    밀리초 번호 UTC 시간 자정에 추가할 시간입니다.

    단위: 밀리초

    이 예에서는 자정(UTC)에 10초를 추가한 다음 인스턴스가 있는 시간대에 맞게 조정하는 방법을 보여줍니다. 이 경우에는 UTC에서 -8시간입니다.

    var gt = new GlideTime(10000); 
gs.info(gt.getDisplayValue());

    출력:

    16:00:10

    GlideTime - getByFormat(문자열 형식)

    지정된 형식으로 시간을 반환합니다.

    이 메서드에 전달할 수 있는 시간 형식에 대한 자세한 내용은 전역 날짜 및 시간 필드 형식을 참조하세요. 이러한 값을 원하는 순서로 전달하고 대시, 공백 슬래시 또는 콜론과 같은 구분 기호를 추가할 수 있습니다. 또한 문자 "a"를 전달하여 am/pm을 반환할 수도 있습니다.

    표 3. 매개변수
    이름 유형 설명
    format 문자열 시간 형식에 사용할 문자열입니다.
    예를 들어 현재 시간이 10:30:20이면 다음을 수행합니다.
    • hh:mm:ss = 10:30:20
    • HH = 10
    • HH –- ss = 10 –- 20
    • hh a = 오전 10시
    • s:m:H ss:mm:hh = 20:30:10 20:30:10
    • HH/mm/ss = 10/30/20
    표 4. 반환
    유형 설명
    문자열 지정된 형식의 시간입니다. 
    var gt = new GlideTime(); 
gt.setValue('12:00:00');
gs.info(gt.getByFormat("HH:mm"));
    출력: 
    12:00

    GlideTime - getDisplayValue()

    현재 사용자의 표시 형식과 시간대에서 시간을 가져옵니다.

    비즈니스 규칙 또는 스크립트 포함을 디자인할 때 이 메서드는 사용자마다 다른 형식으로 값을 반환할 수 있음을 기억하십시오.

    표 5. 매개변수
    이름 유형 설명
    안 함
    표 6. 반환
    유형 설명
    문자열 사용자의 형식과 시간대의 시간입니다. 
    var gt = new GlideTime();
gt.setDisplayValue("12:00:00"); // User Time Zone
gs.info(gt.getDisplayValue()); // User Time Zone

    GlideTime - getDisplayValueEx(문자열 스타일)

    현재 사용자의 시간대와 지정된 형식을 사용하여 시간을 반환합니다.

    표 7. 매개변수
    이름 유형 설명
    스타일 문자열 시간에 사용할 형식입니다.
    유효한 값(대/소문자 구분 안 함):
    • 짧게: HH:mm(AM/PM)
    • 중간: HH:mm:ss(AM/PM)
    • long: HH:mm:ss(AM/PM) 시간대 약어
    • 전체: HH:mm:ss(AM/PM) 시간대

    시간은 현재 사용자의 언어로 반환됩니다. 언어는 시간이 12시간 또는 24시간 형식으로 반환되는지 여부를 결정합니다.
    표 8. 반환
    유형 설명
    문자열 지정된 형식의 시간입니다.

    이 예에서는 현재 사용자의 시간대와 각 서식 옵션을 사용하여 시간을 반환합니다.

    var gt = new GlideTime();
gs.info(gt.getDisplayValueEx("short"));
gs.info(gt.getDisplayValueEx("medium"));
gs.info(gt.getDisplayValueEx("long"));
gs.info(gt.getDisplayValueEx("full"));

    출력:

    8:52 AM  //short
8:52:24 AM  //medium
8:52:24 AM PST  //long
8:52:24 AM Pacific Standard Time  //full

    GlideTime - getDisplayValueInternal()

    현재 사용자의 시간대와 내부 형식(HH:mm:ss)으로 표시 값을 가져옵니다.

    표 9. 매개변수
    이름 유형 설명
    안 함
    표 10. 반환
    유형 설명
    문자열 현재 사용자의 시간대에 있는 GlideTime 객체의 시간 값과 HH:mm:ss의 내부 시간 형식입니다. 
    var gt = new GlideTime();
gt.setValue("01:00:00"); //Internal Time Zone , UTC
gs.info(gt.getDisplayValueInternal()); //User Time Zone

    GlideTime - getDisplayValueLang(문자열 스타일, 문자열 언어)

    현재 사용자의 시간대와 지정된 형식 및 언어를 사용하여 시간을 반환합니다.

    표 11. 매개변수
    이름 유형 설명
    스타일 문자열 시간에 사용할 형식입니다.
    유효한 값(대/소문자 구분 안 함):
    • 짧게: HH:mm(AM/PM)
    • 중간: HH:mm:ss(AM/PM)
    • long: HH:mm:ss(AM/PM) 시간대 약어
    • 전체: HH:mm:ss(AM/PM) 시간대
    언어 문자열 옵션입니다. 시간을 반환할 언어로, BCP 47 언어 태그로 제공됩니다. 예를 들어 일본어로 시간을 반환하려면 ja 태그를 사용합니다.

    언어는 시간이 12시간 또는 24시간 형식으로 반환되는지 여부를 결정합니다. 예를 들어, 영어 시간은 12시간 형식을 사용하고 일본어 시간은 24시간 형식을 사용합니다.

    기본값: 현재 사용자의 언어입니다.
    표 12. 반환
    유형 설명
    문자열 지정된 형식과 언어로 된 시간입니다.

    이 예에서는 현재 사용자의 시간대와 각 서식 옵션을 사용하여 스페인어로 시간을 반환합니다.

    var gt = new GlideTime();
gs.info(gt.getDisplayValueLang("short", "es"));
gs.info(gt.getDisplayValueLang("medium", "es"));
gs.info(gt.getDisplayValueLang("long", "es"));
gs.info(gt.getDisplayValueLang("full", "es"));

    출력:

    9:25  //short
9:25:44  //medium
9:25:44 PST  //long
9:25:44 (hora estándar del Pacífico)  //full

    GlideTime - getHourLocalTime()

    현지 시간대를 사용하여 시간의 시간 부분을 반환합니다.

    표 13. 매개변수
    이름 유형 설명
    안 함
    표 14. 반환
    유형 설명
    번호 현지 시간대를 사용하는 시간입니다.

    GlideTime - getHourOfDayLocalTime()

    현지 시간대를 사용하여 시간의 시간 부분을 반환합니다. 시간 수는 24시간제를 기준으로 합니다.

    표 15. 매개변수
    이름 유형 설명
    안 함
    표 16. 반환
    유형 설명
    번호 현지 시간대를 사용하는 시간입니다. 시간 수는 24시간제를 기준으로 합니다.

    GlideTime - getHourOfDayUTC()

    UTC 시간대를 사용하여 시간의 시간 부분을 반환합니다. 시간 수는 24시간제를 기준으로 합니다.

    표 17. 매개변수
    이름 유형 설명
    안 함
    표 18. 반환
    유형 설명
    번호 UTC 시간대를 사용하는 시간입니다. 시간 수는 24시간제를 기준으로 합니다.

    GlideTime - getHourUTC()

    UTC 시간대를 사용하여 시간의 시간 부분을 반환합니다. 시간 수는 12시간제를 기준으로 합니다. 정오와 자정은 12가 아닌 0으로 표시됩니다.

    표 19. 매개변수
    이름 유형 설명
    안 함
    표 20. 반환
    유형 설명
    번호 UTC 시간대를 사용하는 시간입니다. 시간 수는 12시간제를 기준으로 합니다. 정오와 자정은 12가 아닌 0으로 표시됩니다.

    GlideTime - getMinutesLocalTime()

    로컬 시간대를 사용하여 분 수를 반환합니다.

    표 21. 매개변수
    이름 유형 설명
    안 함
    표 22. 반환
    유형 설명
    번호 로컬 시간대를 사용하는 분 수입니다.

    GlideTime - getMinutesUTC()

    UTC 시간대를 기준으로 시간의 분 수를 반환합니다.

    표 23. 매개변수
    이름 유형 설명
    안 함
    표 24. 반환
    유형 설명
    번호 UTC 시간대를 사용한 시간의 분 수입니다.

    GlideTime - getSeconds()

    현재 분의 초 수를 반환합니다.

    표 25. 매개변수
    이름 유형 설명
    안 함
    표 26. 반환
    유형 설명
    번호 분 단위의 초 수입니다.

    GlideTime - getValue()

    GlideTime 객체로 데이터베이스에 저장된 시간 값을 내부 형식, HH:mm:ss 및 시스템 시간대로 가져옵니다.

    표 27. 매개변수
    이름 유형 설명
    안 함
    표 28. 반환
    유형 설명
    문자열 내부 포맷 및 시스템 시간대의 시간 값입니다. 
    var gt = new GlideTime();
gs.info(gt.getValue()); // Internal Time Zone, UTC

    GlideTime - setDisplayValue(문자열 asDisplayed)

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

    표 29. 매개변수
    이름 유형 설명
    asDisplayed 문자열 현재 사용자의 표시 형식과 시간대의 시간입니다. 매개변수는 현재 사용자가 선호하는 표시 형식(예: HH:mm:ss)을 사용하여 형식을 지정해야 합니다.
    표 30. 반환
    유형 설명
    안 함 
    var gt = new GlideTime();
gt.setDisplayValue('01:00:00');   // User Time Zone
gs.info(gt.getDisplayValueInternal()); // User Time Zone

    GlideTime - setDisplayValueEx(문자열 시간, 문자열 스타일)

    현재 사용자의 시간대와 지정된 형식을 사용하여 시간을 설정합니다.

    표 31. 매개변수
    이름 유형 설명
    시간 문자열 시간에 대해 설정할 값입니다.
    getDisplayValueEx() 메서드는 유효한 형식으로 시간을 반환하거나 아래와 같이 시간 형식을 지정할 수 있습니다.
    • HH:mm(오전/오후)
    • HH:mm:ss(오전/오후)
    • HH:mm:ss(AM/PM) 시간대 약어
    • HH:mm:ss(AM/PM) 시간대
    현재 사용자의 언어에 따라 12시간(AM/PM) 또는 24시간 값이 허용되는지 여부가 결정됩니다. 예를 들어 현재 사용자의 언어가 영어이면 오후 6시 25분(PST )은 유효한 값이고 18시 25분(PST )은 그렇지 않습니다.
    스타일 문자열 시간에 사용할 형식입니다.

    제공된 time 값과 동일한 형식을 사용해야 합니다.

    유효한 값(대/소문자 구분 안 함):
    • 짧게: HH:mm(AM/PM)
    • 중간: HH:mm:ss(AM/PM)
    • long: HH:mm:ss(AM/PM) 시간대 약어
    • 전체: HH:mm:ss(AM/PM) 시간대
    표 32. 반환
    유형 설명
    없음

    이 예에서는 현재 사용자의 시간대와 지정된 형식을 사용하여 시간을 설정합니다.

    gt = new GlideTime();
gt.setDisplayValueEx("8:25:25 AM", "medium");
gs.info(gt.getDisplayValueEx("full"));

    출력:

    8:25:25 AM Pacific Standard Time

    GlideTime - setDisplayValueLang(문자열 시간, 문자열 스타일, 문자열 언어)

    현재 사용자의 시간대와 지정된 형식 및 언어를 사용하여 시간을 설정합니다.

    표 33. 매개변수
    이름 유형 설명
    시간 문자열 시간에 대해 설정할 값입니다.
    getDisplayValueLang() 및 getDisplayValueEx() 메서드는 유효한 형식으로 시간을 반환하거나 아래와 같이 시간 형식을 지정할 수 있습니다.
    • HH:mm(오전/오후)
    • HH:mm:ss(오전/오후)
    • HH:mm:ss(AM/PM) 시간대 약어
    • HH:mm:ss(AM/PM) 시간대
    이 매개변수는 language 12시간(AM/PM) 또는 24시간 값을 허용할지 여부를 결정합니다. 예를 들어 언어가 en (영어)이면 오후 6:25 PST 는 유효한 값이지만 18:25 PST 는 그렇지 않습니다.
    스타일 문자열 시간에 사용할 형식입니다.

    제공된 time 값과 동일한 형식을 사용해야 합니다.

    유효한 값(대/소문자 구분 안 함):
    • 짧게: HH:mm(AM/PM)
    • 중간: HH:mm:ss(AM/PM)
    • long: HH:mm:ss(AM/PM) 시간대 약어
    • 전체: HH:mm:ss(AM/PM) 시간대
    언어 문자열 시간을 설정할 언어로, BCP 47 언어 태그로 제공됩니다. 예를 들어 일본어로 시간을 설정하려면 ja 태그를 사용합니다.
    표 34. 반환
    유형 설명
    없음

    이 예에서는 현재 사용자의 시간대를 사용하여 영어로 시간을 설정하고 스페인어로 검색합니다.

    gt = new GlideTime();
gt.setDisplayValueLang("4:15:00 PM PST", "long", "en");
gs.info(gt.getDisplayValueLang("full", "es"));

    출력:

    16:15:00 (hora estándar del Pacífico)

    GlideTime - setValue(String o)

    내부 시간대에서 GlideTime 객체의 시간을 설정합니다.

    표 35. 매개변수
    이름 유형 설명
    o 문자열 hh:mm:ss 형식의 시간입니다.
    표 36. 반환
    유형 설명
    안 함 
    var gt = new GlideTime();
gt.setValue('01:00:00');  //Internal Time Zone, UTC
gs.info("time is "+ gt.getByFormat('hh:mm:ss'));

    GlideTime - subtract(GlideTime startTime, GlideTime endTime)

    두 GlideTime 객체 값 간의 기간 차이를 가져옵니다.

    표 37. 매개변수
    이름 유형 설명
    startTime 글라이드타임 시작 값입니다.
    endTime 글라이드타임 종료 값입니다.
    표 38. 반환
    유형 설명
    GlideDuration 두 값 사이의 지속 기간입니다. 
    var gd1 = new GlideTime(); 
gd1.setDisplayValue("09:00:00"); 
var gd2 = new GlideTime(); 
gd2.setDisplayValue("09:10:00"); 
 
var dur = GlideDate.subtract(gd1, gd2); //the difference between gdt1 and gdt2 
gs.info(dur.getDisplayValue());