Time in Range

calculateEnhancedTIR

calculateEnhancedTIR(readings: GlucoseReading[], options?: EnhancedTIROptions): EnhancedTIRResult

Calculates Enhanced Time-in-Range metrics per International Consensus 2019.

Provides detailed breakdown of glucose readings across five clinical ranges:

• Very Low (<54 mg/dL / 3.0 mmol/L): Level 2 Hypoglycemia
• Low (54-69 mg/dL / 3.0-3.8 mmol/L): Level 1 Hypoglycemia
• In Range (70-180 mg/dL / 3.9-10.0 mmol/L): Target Range
• High (181-250 mg/dL / 10.1-13.9 mmol/L): Level 1 Hyperglycemia
• Very High (>250 mg/dL / >13.9 mmol/L): Level 2 Hyperglycemia

Returns — Enhanced TIR result with detailed metrics and target assessment

Throws — If readings array is empty

Throws — If readings contain invalid glucose values

const readings: GlucoseReading[] = [
  { value: 120, unit: 'mg/dL', timestamp: '2024-01-01T08:00:00Z' },
  { value: 95, unit: 'mg/dL', timestamp: '2024-01-01T08:05:00Z' },
  // ... more readings
];
const result = calculateEnhancedTIR(readings);
console.log(`TIR: ${result.inRange.percentage}%`);
console.log(`Meets targets: ${result.meetsTargets.tirMeetsGoal}`);

See: International Consensus on Time in Range (2019)

calculatePregnancyTIR

calculatePregnancyTIR(readings: GlucoseReading[], options?: PregnancyTIROptions): PregnancyTIRResult

Calculates Pregnancy-specific Time-in-Range metrics per ADA 2024 guidelines.

Uses tighter target range for pregnancy: 63-140 mg/dL (3.5-7.8 mmol/L). Consensus targets: TIR >70%, TBR <4% (Level 1) and <1% (Level 2), TAR <25%.

Returns — Pregnancy TIR result with target assessment and recommendations

Throws — If readings array is empty

Throws — If readings contain invalid glucose values

const readings: GlucoseReading[] = [
  { value: 100, unit: 'mg/dL', timestamp: '2024-01-01T08:00:00Z' },
  // ... more readings
];
const result = calculatePregnancyTIR(readings);
console.log(`TIR: ${result.inRange.percentage}%`);
console.log(`Meets pregnancy targets: ${result.meetsPregnancyTargets}`);

See: ADA Standards of Care (2024)

calculateTimeInRange

calculateTimeInRange(readings: number[], lower: number, upper: number): number

Calculates the percentage of glucose readings within a specified numeric range. Used for clinical TIR analytics and custom range assessments.

Returns — Percentage of readings within the specified range (0-100)

calculateTIR

calculateTIR(readings: GlucoseReading[], target: { … }): TIRResult

Calculates clinical Time in Range (TIR) metrics for glucose readings. Returns the percentage of readings in, below, and above the specified clinical target range.

Returns — Object with in-range, below-range, and above-range percentages

See: https://care.diabetesjournals.org/content/42/8/1593

calculateTITR

calculateTITR(readings: GlucoseReading[], options?: TITROptions): TITRResult

Calculates Time in Tight Range (TITR), the percentage of readings within a tighter 70-140 mg/dL band than standard TIR (70-180). Emerging consensus target is >50%.

Unlike calculateTIR, input readings are normalized to mg/dL first, so mixed-unit series are handled correctly. Thresholds are always mg/dL.

Returns — Tight-range breakdown with target assessment

calculateTITR(readings).inRange // e.g. 58.3

See: International Consensus on Time in Range (2019)

getTIRSummary

getTIRSummary(result: TIRResult): string

Generates a clinical summary string from a TIRResult object. Used for reporting and visualization of TIR analytics.

Returns — String summarizing in-range, below-range, and above-range percentages (e.g., 'In Range: 70%, Below: 10%, Above: 20%')

groupByDay

groupByDay(readings: GlucoseReading[]): Record<string, GlucoseReading[]>

Groups glucose readings by date (YYYY-MM-DD).

Returns — An object mapping each date string to an array of readings for that day.