Times-Per-Day Schedule Builder

Reformat an actual separately clinician-established within-day administration schedule onto explicit time line, no infer times from frequency, choose evenly spaced regimen or medication timing/safety.

Description

A medication schedule needs actual established administration times, since a frequency alone does not determine the appropriate times.

A medication schedule needs actual established administration times, since a frequency alone does not determine the appropriate times.^[1]

This tool places supplied within-period offsets onto one explicit timeline without choosing a regimen.

When to use Times-Per-Day Schedule Builder

This tool places supplied within-period offsets onto one explicit timeline without choosing a regimen.

How to use Times-Per-Day Schedule Builder and how it works

Prepare clinician established administration minutes from period start, period start minute on one timeline, period length minutes, using the input definitions and matching units below.
Enter the required fields and run Times-Per-Day Schedule Builder.
Read result.recordedScheduledMinutesOnTimeline using the units, signs and ordering explained below.
Correct any rejected inputs and rerun; interpret the result within the stated model and its assumptions.

Input field	Meaning	Value type	Requirement
callerClinicianEstablishedAdministrationMinutesFromPeriodStart	Nonempty strictly increasing established minute offsets, each in [0,periodLength).	array of number	Required; other constraints below
actualPeriodStartMinuteOnOneTimeline	Finite signed minute coordinate of the period start on one explicit timeline.	number	Required; finite; other constraints below
actualPeriodLengthMinutes	Positive period duration in minutes; no administration times are chosen from it.	number	Required; strictly positive; finite; other constraints below

Require a positive period length and a nonempty list of independently established administration offsets. Offsets must be strictly increasing, nonnegative and strictly below period length. Add the supplied period-start minute to every offset and return the scheduled minutes on that one timeline in order. The start may be a signed finite coordinate. No times are inferred from frequency, no time-zone conversion occurs and no regimen is chosen.

timelineMinute_i=periodStartMinute+establishedOffset_i

Apply the input ordering, units and branch conditions stated above.

Output field	Meaning	Value type
result	Object containing the calculated or selected fields below.	object
result.recordedScheduledMinutesOnTimeline	Established scheduled minute coordinates on the supplied timeline, in input order.	array of number

json

{
  "input": {
    "callerClinicianEstablishedAdministrationMinutesFromPeriodStart": [
      0,
      360
    ],
    "actualPeriodStartMinuteOnOneTimeline": 100,
    "actualPeriodLengthMinutes": 1440
  },
  "output": {
    "result": {
      "recordedScheduledMinutesOnTimeline": [
        100,
        460
      ]
    }
  }
}

Limitations and assumptions

Patient context, drug formulation, route, sampling time, assay units and applicable clinician-verified protocol must be independently established. The output supplies no dosing, titration, switching or administration instruction.

The calculation uses the supplied observations and model inputs. It does not collect measurements, select a reference population or coefficient, or establish that the model applies to the actual case. The stated branch conditions and output units remain part of the result.

All fields require explicit values. Unexpected fields, wrong types, nonfinite numbers and sparse arrays are rejected. Alignment, bounds and supported-token rules are explained above; extremely large inputs or nonfinite results can also fail. Input errors differ from successful false comparisons, unavailable-domain flags and empty match lists.

Alternative or Complementary methods

Use Tablet Days Supply Split Calculator for a complementary operation: Splitting a tablet changes the number of available pieces, which affects an inventory's nominal days of supply.

Use Refills Until Next Fill Calculator for a complementary operation: Inventory coverage and the time until a next fill are separate quantities that can be compared on a calendar.

References

Times-Per-Day Schedule Builder — tool.io

Similar or alternative tools

Tablet Days Supply Split Calculator
Splitting a tablet changes the number of available pieces, which affects an inventory's nominal days of supply.
Refills Until Next Fill Calculator
Inventory coverage and the time until a next fill are separate quantities that can be compared on a calendar.