Availability
This routine is available starting with SIL Engine™ 2.5.
Syntax
toRawWorkingInterval (interval, [workingHours/day]);
Description
Returns a date interval converted to the specified number of hours per day.This routine re-writes a 24h day interval in an interval that is based on 8h (for instance). It is not sensitive for weekends, holidays, leave without pay, and so on.
The result interval is converted using the workingHours/day parameter that is optional and is an integer between 1 and 24. This routine can be used to view how much hours can a user work during a week, for instance.
Parameters
Parameter name | Type | Required | Description |
|---|---|---|---|
interval | interval | Yes | Specifies a date interval that will be converted from 24 hours/day to working hours/day. |
| format | number | No | Specifies the number of working hours per day the interval will be converted to. The default number is 8, if another number isn't specified. |
Return type
interval
The return value represents the converted interval from the interval given as argument.
Example
Example 1
Let us consider the following SIL code:
date begin = "2013-01-17T12:30:00"; date end = "2013-01-28T16:30:00"; return toRawWorkingInterval(end - begin, 6);
This will return "2d 22h" due to:
- The interval between begin date and end date is 11d 4h.
- If we convert a day from 24 hours to a 6 hour per day we will make the following computation: 11d * 6h + 4h = 66h + 4h = 70h that will be viewed as 2d 22h.
Example 2
By running this code:
date begin = "2013-01-17T02:30:00"; date end = "2013-01-28T16:30:00"; return toRawWorkingInterval(end - begin);
The result will return "4d" due to:
- The interval is "11d 12h" long.
- The conversion is based on this computation: 12d * 8h(default hours) = 96h that means "4d".
- This is done so because the number of hours in the 12th day of the interval exceeds the number of working hours per day (by default 8) and a new day is added.
See also