GlideDuration - 범위 지정됨

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 7분
  • GlideDuration 클래스는 기간이라고 하는 시간 범위를 사용하여 작업하기 위한 메서드를 제공합니다.

    GlideDuration 객체는 기간을 1970년 1월 1일 00:00:00부터 날짜 및 시간으로 저장합니다. 따라서 setValue()getValue() 메서드는 매개변수 및 반환 값에 범위가 지정된 GlideDateTime 객체를 사용합니다.

    GlideDuration - GlideDuration()

    GlideDuration 객체를 인스턴스화합니다.

    표 1. 매개변수
    이름 유형 설명
    없음

    GlideDuration - GlideDuration(GlideDuration, 기타)

    전달된 GlideDuration 객체의 값을 복제하여 GlideDuration 객체를 인스턴스화합니다.

    표 2. 매개변수
    이름 유형 설명
    다른 GlideDuration GlideDuration 객체입니다.
    var duration = new GlideDuration('3 12:00:00');
    var duration2 = new GlideDuration(duration);
    gs.info(duration2.getDisplayValue());

    출력:

    3 Days 12 Hours

    GlideDuration - GlideDuration(밀리초 수)

    지정된 기간(밀리초)으로 GlideDuration 객체를 인스턴스화합니다.

    표 3. 매개변수
    이름 유형 설명
    밀리초 번호 기간 값입니다.

    단위: 밀리초

    var dur = new GlideDuration(60000);
    gs.info(dur.getDurationValue());

    출력:

    00:01:00

    GlideDuration - GlideDuration(문자열 displayValue)

    지정된 기간 표시 값으로 GlideDuration 객체를 인스턴스화합니다.

    표 4. 매개변수
    이름 유형 설명
    displayValue 문자열 기간 값입니다.

    형식: d HH:mm:ss, 여기서 "d"는 일 수입니다.

    var duration = new GlideDuration('3 12:00:00');
    var duration2 = new GlideDuration('3:00:00');
    var answer = duration.add(duration2);
    gs.info(answer.getDisplayValue());

    출력:

    3 Days 15 Hours

    GlideDuration - add(GlideDuration 기간)

    지정된 GlideDuration 객체의 지속 시간을 현재 GlideDuration 객체에 추가합니다.

    표 5. 매개변수
    이름 유형 설명
    기간 GlideDuration 현재 GlideDuration 객체에 추가할 기간 값을 포함하는 GlideDuration 객체입니다.
    표 6. 반환
    유형 설명
    GlideDuration 기간이 두 GlideDuration 개체의 기간 합계인 새 GlideDuration 개체입니다.
    var duration = new GlideDuration('3 12:00:00');
    var duration2 = new GlideDuration('3:00:00');
    var answer = duration.add(duration2);
    gs.info(answer.getDisplayValue());

    출력:

    3 Days 15 Hours

    GlideDuration - getByFormat(문자열 형식)

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

    표 7. 매개변수
    이름 유형 설명
    format 문자열 기간 형식입니다.

    형식: 전역 날짜 및 시간 필드 형식

    표 8. 반환
    유형 설명
    문자열 지정된 형식의 현재 기간입니다.
    var dur = new GlideDuration('3 22:00:00');
    gs.info(dur.getByFormat('HH:mm'));

    출력

    22:00

    GlideDuration - getDayPart()

    일 수를 반환합니다.

    표 9. 매개변수
    이름 유형 설명
    없음
    표 10. 반환
    유형 설명
    번호 지속 기간의 일 수입니다.
    var dur = new GlideDuration('3 12:00:00');
    gs.info(dur.getDayPart());

    출력:

    3

    범위가 지정된 GlideDuration - getDisplayValue()

    기간의 표시 값을 일, 시간, 분 수로 반환합니다.

    표 11. 매개변수
    이름 유형 설명
    없음
    표 12. 반환
    유형 설명
    문자열 일, 시간 및 분 수입니다(예: 2일 10시간 36분).

    형식: 표시 값: "n" 일 "n" 시간 "n" 분

    var dur = new GlideDuration('3 12:00:00');
    gs.info(dur.getDisplayValue());

    출력:

    3 Days 12 Hours

    GlideDuration - getDurationValue()

    지속 시간 값을 "d HH:mm:ss" 형식으로 반환합니다.

    표 13. 매개변수
    이름 유형 설명
    없음
    표 14. 반환
    유형 설명
    문자열 기간 값입니다.

    형식: d HH:mm:ss, 여기서 "d"는 일 수입니다.

    var dur = new GlideDuration(60000);
    gs.info(dur.getDurationValue());

    출력:

    00:01:00

    GlideDuration - getRoundedDayPart()

    반올림된 일 수를 반환합니다. 시간 부분이 12시간을 초과하면 반환 값이 반올림됩니다. 그렇지 않으면 반올림됩니다.

    표 15. 매개변수
    이름 유형 설명
    없음
    표 16. 반환
    유형 설명
    번호 반올림된 표시 값의 일 값입니다.
    var dur = new GlideDuration('3 14:00:00');
    gs.info(dur.getRoundedDayPart());

    출력:

    4

    GlideDuration - getValue()

    현재 GlideDuration 객체의 내부 날짜/시간 값을 반환합니다.

    GlideDuration 객체는 기간을 1970년 1월 1일 00:00:00부터의 날짜 및 시간으로 저장합니다.

    표 17. 매개변수
    이름 유형 설명
    없음
    표 18. 반환
    유형 설명
    문자열 GlideDuration 객체 내의 현재 기간입니다.

    형식: YYYY-MM-DD HH:mm:ss

    var dur = new GlideDuration('3 12:00:00');
    gs.info(dur.getValue());
    출력:
    1970-01-04 12:00:00

    GlideDuration - setDisplayValue(String asDisplayed)

    기간 표시 값을 설정합니다.

    표 19. 매개변수
    이름 유형 설명
    표시된 대로 문자열 설정할 기간 값을 표시합니다.

    형식: d HH:mm:ss 여기서 "d"는 일 수입니다.

    표 20. 반환
    유형 설명
    없음
    var dur = new GlideDuration(); 
    dur.setDisplayValue('3 08:00:00');
    gs.info(dur.getDisplayValue());

    출력:

    3 Days 8 Hours

    GlideDuration - setValue(객체 o)

    GlideDuration 객체의 내부 날짜/시간 값을 설정합니다.

    메서드는 지속 시간 값을 전달된 날짜/시간과 기본 날짜/시간 값인 1970년 1월 1일 00:00:00의 차이로 설정합니다. 전달된 날짜/시간 객체(문자열)는 GlideDateTime 객체로 구문 분석됩니다.

    표 21. 매개변수
    이름 유형 설명
    o 객체 계산된 기간 동안 엔드포인트로 사용할 날짜 및 시간입니다.

    형식: YYYY-MM-DD HH:mm:ss

    표 22. 반환
    유형 설명
    없음
    var dur = new GlideDuration();
    dur.setValue('1970-01-05 08:00:00'); // sets internal DateTime value. The String is parsed into a GlideDateTime object.
    gs.info(dur.getDisplayValue());
    출력:
    4 Days 8 Hours

    GlideDuration - 빼기(GlideDuration 기간)

    지정된 GlideDuration 객체의 지속 시간을 현재 GlideDuration 객체에서 뺍니다.

    표 23. 매개변수
    이름 유형 설명
    기간 GlideDuration 현재 GlideDuration 객체에서 뺄 지속 시간 값이 들어 있는 GlideDuration 객체입니다.
    표 24. 반환
    유형 설명
    GlideDuration 두 GlideDuration 객체의 지속 기간을 뺀 결과가 기간에 포함된 새 GlideDuration 객체입니다.
    var duration = new GlideDuration('3 12:00:00');
    var duration2 = new GlideDuration('3:00:00');
    var answer = duration.subtract(duration2);
    gs.info(answer.getDisplayValue());
    출력:
    3 Days 9 Hours