GlideDuration- Scoped

The GlideDuration class provides methods for working with spans of time known as durations.

GlideDuration objects store the duration as the number of days and time from January 1, 1970, 00:00:00. As a result, the setValue() and getValue() methods use the scoped GlideDateTime object for parameters and return values.

Parent Topic:Server API reference

GlideDuration - GlideDuration()

Instantiates a GlideDuration object.

GlideDuration - GlideDuration(GlideDuration another)

Instantiates a GlideDuration object by cloning the values of the passed in GlideDuration object.

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

Output:

3 Days 12 Hours

GlideDuration - GlideDuration(Number milliseconds)

Instantiates a GlideDuration object with the specified duration in milliseconds.

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

Output:

00:01:00

GlideDuration - GlideDuration(String displayValue)

Instantiates a GlideDuration object with the specified duration display value.

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

Output:

3 Days 15 Hours

GlideDuration - add(GlideDuration duration)

Adds the duration of the specified GlideDuration object to the current GlideDuration object.

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

Output:

3 Days 15 Hours

GlideDuration - getByFormat(String format)

Returns the duration value in the specified format.

var dur = new GlideDuration('3 22:00:00');
gs.info(dur.getByFormat('HH:mm'));

Output

22:00

GlideDuration - getDayPart()

Returns the number of days.

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

Output:

3

Scoped GlideDuration - getDisplayValue()

Returns the display value of the duration in number of days, hours, and minutes.

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

Output:

3 Days 12 Hours

GlideDuration - getDurationValue()

Returns the duration value in "d HH:mm:ss" format.

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

Output:

00:01:00

GlideDuration - getRoundedDayPart()

Returns the rounded number of days. If the time part is more than 12 hours, the return value is rounded up. Otherwise, it is rounded down.

var dur = new GlideDuration('3 14:00:00');
gs.info(dur.getRoundedDayPart());

Output:

4

GlideDuration - getValue()

Returns the internal date/time value of the current GlideDuration object.

GlideDuration objects store the duration as a date and time from January 1, 1970, 00:00:00.

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

Output:

1970-01-04 12:00:00

GlideDuration - setDisplayValue(String asDisplayed)

Sets the duration display value.

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

Output:

3 Days 8 Hours

GlideDuration - setValue(Object o)

Sets the internal date/time value of the GlideDuration object.

The method sets the duration value to the difference of the passed in date/time the base date/time value of January 1, 1970, 00:00:00. The passed in date/time object (string) is parsed into a GlideDateTime object.

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

Output:

4 Days 8 Hours

GlideDuration - subtract(GlideDuration duration)

Subtracts the duration of the specified GlideDuration object to the current GlideDuration object.

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

Output:

3 Days 9 Hours