Description
Divide nonnegative actualDuration by positive plannedDuration.
Time-window accounting separates gross duration, overlap, pauses, and eligible exposure. A fraction is interpretable only when its numerator and denominator use compatible intervals and units.
Divide nonnegative actualDuration by positive plannedDuration.
When to use this tool
Use Timed Collection Duration Ratio when you need to reconcile explicit durations or interval support.
How to use the tool and how it works
- Enter actualDuration, plannedDuration. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read ratio. Use the output convention below.
Divide nonnegative actualDuration by positive plannedDuration.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| actualDuration | Actual Duration | Required. Finite number; minimum 0. |
| plannedDuration | Planned Duration | Required. Finite number; strictly above 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| ratio | Dimensionless ratio when numerator and denominator use compatible units. | Required. Finite number. |
json
{
"input": {
"actualDuration": 18,
"plannedDuration": 24
},
"output": {
"ratio": 0.75
}
}Limitations and assumptions
- Use matching time units; ratios above one are allowed and do not establish collection validity.
- Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
- Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.
Alternative or Complementary methods
Use timestamped intervals to calculate overlap unions when summed durations and supplied corrections are insufficient.
References
Similar or alternative tools
- Collection Pause Support Share
Sum active time and the active time marked complete; divide supported by all active time.
- Urine Collection Window Fraction
Intersect the collection and target intervals.