Description
Measure an oncology visit's signed calendar offset from its planned date.
Oncology records distinguish individual lesion measurements, missingness reasons, source coding, visit timing and assigned treatment-line labels. A signed axis change is not automatically a response category or stage. Clinical endpoints and regimen records require their verified definitions; local arithmetic and transcription do not determine diagnosis, outcome or treatment.
Measure an oncology visit's signed calendar offset from its planned date.
When to use this tool
Use Oncology Visit Due Offset when you already have plannedDate, actualDate and need to measure an oncology visit's signed calendar offset from its planned date.
How to use the tool and how it works
- Enter plannedDate, actualDate. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read signedCalendarDayOffset. Use the output convention below.
Parse real UTC dates; return actualDate-plannedDate in days.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| plannedDate | Planned Date | Required. Text; maximum UTF-16 length 8192. Real proleptic Gregorian YYYY-MM-DD; four-digit years 0000-9999 accepted. |
| actualDate | Actual Date | Required. Text; maximum UTF-16 length 8192. Real proleptic Gregorian YYYY-MM-DD; four-digit years 0000-9999 accepted. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| signedCalendarDayOffset | Signed Calendar Day Offset | Required. Finite number. |
{
"input": {
"plannedDate": "2026-11-01",
"actualDate": "2026-11-04"
},
"output": {
"signedCalendarDayOffset": 3
}
}Limitations and assumptions
- A positive offset is later than planned; no visit urgency, recommended interval or care outcome is assessed.
- 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.
Alternative or Complementary methods
Use the complete source-defined lesion, registry and outcome criteria with verified records for an assessment. Keep missingness reasons, measurement axes and assigned treatment-line wording explicit; a single signed dimension change or event-date token does not establish response or stage.
References
Similar or alternative tools
- Oral Surgery Procedure Follow Up Day
Measure a follow-up date's signed days after a supplied procedure date.
- Oncology Questionnaire Recall Period
Label a questionnaire's supplied recall days and assessment date.