Page History

The objects of this server class store duration as a date and time from starting with January 1, 1970, 00:00:00.

SimpleDuration(duration)

Instantiates a new SimpleDuration object.

Parameter(s):

Example:

const durationOne = new SimpleDuration(3600);
const durationTwo = new SimpleDuration('00:30:00');

add(duration)

Summarizes This method sums two SimpleDuration objects and returns the result.

Parameter(s):

Return:

Example:

const durationOnevar simple_duration = new SimpleDuration("2 10:00:00"3600);
var simple_duration_1const durationTwo = new SimpleDuration("01'00:0030:00"');
varconst resulttotalDuration = simple_durationdurationOne.add(simple_duration_1durationTwo);
ss.info( resulttotalDuration.getDisplayValuegetDurationValue() );
// Info: 01:30:00

getByFormat(format)

Returns This method allows to get the duration value of the duration in a specified the format you need.

Parameter(s):

Return:

Example:

const datetimevar simple_duration = new SimpleDuration("2 10:00:00"SimpleDateTime('2019-11-12 15:34:13');
const duration = new SimpleDuration(datetime.getNumericValue());
ss.info( simple_duration.getByFormat('h:m') );j F Y (D) H:i:s'));
// Info: 12 November 2019 (Tue) 15:34:13

getDayPart()

Returns the This method allows to get the duration value in number of the days of the duration.

Return:

Example:

const var simple_duration = new SimpleDuration("2'02 1001:0030:00"');
ss.info( simple_duration.getDayPart() ); 
// Info: 2

getDisplayValue()

Returns This method allows to get the number of the days, hours, and minutes of from the durationSimpleDuration object.

Return:

Example:

varconst simple_duration = new SimpleDuration(3605);
ss.info(duration.getDisplayValue());
// Info: 1 hour 5 seconds

getDurationSeconds()

This method returns the duration value in seconds.

Return:

Example:

const duration = new SimpleDuration('"10 10:00:00"');
ss.info( simple_duration.getDisplayValue() );  //10 days 10 hours

getDurationValue()

duration.getDurationSeconds());
//Info: 36000

getDurationValue()

This method allows to get the value from the SimpleDuration object in 'D H:i:s' format.

Return:

Example:

const duration = new SimpleDuration(7200);
ss.info(duration.getDurationValue());
// Info: 02:00:00

getRoundedDayPart()

This method returns the number of days taking into account the quantity of hours in the SimpleDuration object. If the number of hours is more than 12, the method rounds the value up. Otherwise, it rounds the value down.

Return:

Example:

const duration = new SimpleDuration('5 12:52:22');
ss.info(duration.getRoundedDayPart()); 
//Info: 6

getValue()

This method returns the date and time value in the internal format.

SimpleDuration objects store duration as a date and time starting with January 1, 1970, 00:00:00.

Return:

Example:

const duration = new SimpleDuration('10 15:00:00');
ss.info(duration.getValue());
//Info: 1970-01-11 15:00:00

Example 2:

const myUserId = ss.getUserId();
const timestamp = Number(myUserId.slice(0, 10)); // User created at
const duration = new SimpleDuration(timestamp);
ss.info(duration.getValue());
// Info: 2019-05-31 14:02:39

setDisplayValue(duration)

This method sets the value in a 'd Returns the duration value in 'D H:i:s' format.

Parameter(s):

Return:

Example:

const var simple_duration = new SimpleDuration("10 10:00:00"();
duration.setDisplayValue('2 10:00:00');
ss.info(duration.getDisplayValue());
//Info: 2 days 10 hours

setValue(dateTime)

This method sets the value in a 'YYYY-MM-DD hh:mm:ss' format.

Parameter(s):

Return:

Example:

const durationOne = new SimpleDuration();
durationOne.setValue('2019-08-01 09:00:00');
ss.info(durationOne.getByFormat());
const durationTwo = new SimpleDuration();
durationTwo.setValue(new SimpleDateTime('2019-09-05 12:00:00'));
ss.info( simple_duration.getDurationValue() ); //10 10:00:00durationTwo.getByFormat());
// Info: 2019-08-01 09:00:00
// Info: 2019-09-05 12:00:00

subtract(duration)

This method subtracts one SimpleDuration object from another and returns the result.

Parameter(s):

Return:

Example:

const durationOne = new SimpleDuration();
durationOne.setValue('2019-11-08 20:01:58');
const durationTwo = new SimpleDuration(3600);
const datetime = durationOne.subtract(durationTwo);
ss.info(datetime.getByFormat());
// Info: 2019-11-08 19:01:58