Convert Minutes into Formatted Time String

convertMinutesToTime

Converts a number of minutes into a standardized "HH:MM" time string format.

Aliases

• convertMinutesToHourMinutes
• getTimeFromMinutes
• getHourMinutesFromMinutes

Function Signature

convertMinutesToTime(minutes: Numeric): HourMinutes;

Parameters

• minutes:
  • Type: Numeric (number or numeric string)
  • The total minutes to convert (e.g., 90, "-45", "120")

Return Value

• HourMinutes - A string in hour:minute format where:
  • Hour portion has 1+ digits (e.g., "1:05", "12:30", "123:45" etc.)
  • Minute portion always has 2 digits (e.g., "0:05", "8:00")

Example Usage

Behavior

• Always returns absolute value (ignores negative signs)
• Formats minutes with leading zero (e.g., 5 → "0:05")
• Handles both numbers and numeric strings
• Returns 24+ hour formats for large inputs (e.g., 1500 → "25:00")

Type Safety

Uses strict type definitions:

type HourMinutes = `${number}:${'00'|'01'|...|'59'}`;
type Numeric = number | `${number}`;

Edge Cases