GlideTime - 범위 지정됨

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기6분

    • 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 - getDisplayValueInternal()

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

    표 7. 매개변수
    이름 유형 설명
    없음
    표 8. 반환
    유형 설명
    문자열 현재 사용자의 시간대 및 내부 시간 형식(HH:mm:ss)으로 된 GlideTime 객체의 시간 값입니다. 
    var gt = new GlideTime();
gt.setValue("01:00:00"); //Internal Time Zone , UTC
gs.info(gt.getDisplayValueInternal()); //User Time Zone

    GlideTime - getHourLocalTime()

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

    표 9. 매개변수
    이름 유형 설명
    없음
    표 10. 반환
    유형 설명
    번호 현지 시간대를 사용하는 시간입니다.

    GlideTime - getHourOfDayLocalTime()

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

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

    GlideTime - getHourOfDayUTC()

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

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

    GlideTime - getHourUTC()

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

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

    GlideTime - getMinutesLocalTime()

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

    표 17. 매개변수
    이름 유형 설명
    없음
    표 18. 반환
    유형 설명
    번호 현지 시간대를 사용한 분 수입니다.

    GlideTime - getMinutesUTC()

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

    표 19. 매개변수
    이름 유형 설명
    없음
    표 20. 반환
    유형 설명
    번호 UTC 시간대를 사용한 시간(분)입니다.

    GlideTime - getSeconds()

    현재 분의 시간(초)을 반환합니다.

    표 21. 매개변수
    이름 유형 설명
    없음
    표 22. 반환
    유형 설명
    번호 분 단위의 초 수입니다.

    GlideTime - getValue()

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

    표 23. 매개변수
    이름 유형 설명
    없음
    표 24. 반환
    유형 설명
    문자열 내부 경로 및 시스템 시간대의 시간 값입니다. 
    var gt = new GlideTime();
gs.info(gt.getValue()); // Internal Time Zone, UTC

    GlideTime - setDisplayValue(String asDisplayed)

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

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

    GlideTime - setValue(String o)

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

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

    GlideTime - 빼기(GlideTime startTime, GlideTime endTime)

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

    표 29. 매개변수
    이름 유형 설명
    startTime 글라이드타임 시작 값입니다.
    endTime 글라이드타임 종료 값입니다.
    표 30. 반환
    유형 설명
    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());