GlideTime - 범위 지정

범위가 지정된 GlideTime 클래스는 GlideTime 객체 인스턴스화 또는 GlideTime 필드 작업과 같은 GlideTime 객체에 대한 작업을 수행하기 위한 메서드를 제공합니다.

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

범위가 지정된 GlideTime - getByFormat(문자열 형식)

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

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

표 1. 매개변수

이름	유형	설명
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입니다. SSSZ = 10:30:20.000+0000 HH/mm/ss = 10/30/20

표 2. 반환

유형	설명
문자열	지정된 형식의 시간입니다.

var gt = new GlideTime(); 
gt.setValue('12:00:00');
gs.info(gt.getByFormat("HH:mm"));

출력:

12:00

범위가 지정된 GlideTime - getDisplayValue()

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

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

표 3. 매개변수

이름	유형	설명
없음

표 4. 반환

유형	설명
문자열	사용자 형식 및 시간대의 시간입니다.

var gt = new GlideTime();
gt.setDisplayValue("12:00:00"); // User Time Zone
gs.info(gt.getDisplayValue()); // User Time Zone

범위가 지정된 GlideTime - getDisplayValueInternal()

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

표 5. 매개변수

이름	유형	설명
없음

표 6. 반환

유형	설명
문자열	현재 사용자의 시간대와 내부 시간 형식인 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()

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

표 7. 매개변수

이름	유형	설명
없음

표 8. 반환

유형	설명
번호	현지 표준 시간대를 사용하는 시간입니다.

범위가 지정된 GlideTime - getHourOfDayLocalTime()

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

표 9. 매개변수

이름	유형	설명
없음

표 10. 반환

유형	설명
번호	현지 표준 시간대를 사용하는 시간입니다. 시간 수는 24시간제를 기준으로 합니다.

범위 지정 GlideTime - getHourOfDayUTC()

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

표 11. 매개변수

이름	유형	설명
없음

표 12. 반환

유형	설명
번호	UTC 표준 시간대를 사용하는 시간입니다. 시간 수는 24시간제를 기준으로 합니다.

범위 지정된 GlideTime - getHourUTC()

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

표 13. 매개변수

이름	유형	설명
없음

표 14. 반환

유형	설명
번호	UTC 표준 시간대를 사용하는 시간입니다. 시간 수는 12시간제를 기준으로 합니다. 정오와 자정은 12가 아닌 0으로 표시됩니다.

범위가 지정된 GlideTime - getMinutesLocalTime()

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

표 15. 매개변수

이름	유형	설명
없음

표 16. 반환

유형	설명
번호	현지 시간대를 사용하는 시간(분)입니다.

범위 지정 GlideTime - getMinutesUTC()

UTC 표준 시간대를 기준으로 시간(분)을 반환합니다.

표 17. 매개변수

이름	유형	설명
없음

표 18. 반환

유형	설명
번호	UTC 표준 시간대를 사용하는 시간의 분 수입니다.

범위가 지정된 GlideTime - getSeconds()

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

표 19. 매개변수

이름	유형	설명
없음

표 20. 반환

유형	설명
번호	분 단위의 초입니다.

범위 지정 GlideTime - getValue()

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

표 21. 매개변수

이름	유형	설명
없음

표 22. 반환

유형	설명
문자열	내부 형식 및 시스템 표준 시간대의 시간 값입니다.

var gt = new GlideTime();
gs.info(gt.getValue()); // Internal Time Zone, UTC

범위 지정 GlideTime - GlideTime()

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

표 23. 매개변수

이름	유형	설명
없음

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

범위 지정 GlideTime - GlideTime(밀리초 수)

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

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

표 24. 매개변수

이름	유형	설명
밀리초	번호	UTC 자정에 추가할 시간입니다. 단위: 밀리초

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

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

출력

16:00:10

범위 지정 GlideTime - setDisplayValue(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. 반환

유형	설명
글라이드 기간	두 값 사이의 지속 시간입니다.

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