Skip to contents

Advanced time interval calculation tool designed for survival analysis, epidemiological studies, and person-time analysis. Provides robust date parsing, time interval calculation, landmark analysis, and comprehensive data quality assessment.

Value

List containing calculated intervals, filtered data, quality metrics, and metadata

Details

This function provides comprehensive time interval calculation capabilities including:

  • Multiple date format parsing with automatic detection

  • Flexible output units (days, weeks, months, years)

  • Landmark analysis for conditional survival

  • Person-time calculations for epidemiological studies

  • Data quality assessment and validation

  • Statistical summaries with confidence intervals

  • Export capabilities for downstream analysis

Note

Landmark Analysis Exclusion: When landmark analysis is enabled, participants with missing follow-up times (NA values) are implicitly excluded from the "at-risk" cohort because their eligibility for landmark criteria cannot be determined.

Super classes

jmvcore::Analysis -> ClinicoPath::timeintervalBase -> timeintervalClass

Examples

# Basic time interval calculation:
timeinterval(
  data = study_data,
  dx_date = "diagnosis_date",
  fu_date = "followup_date",
  time_format = "ymd",
  output_unit = "months"
)
#> Error: object 'study_data' not found

# With landmark analysis:
timeinterval(
  data = study_data,
  dx_date = "start_date",
  fu_date = "end_date",
  use_landmark = TRUE,
  landmark_time = 6,
  output_unit = "months"
)
#> Error: object 'study_data' not found