Date Utils

Module defined in lua/common/utils/dateUtils.lua. ISO 8601 date parsing and time difference calculations.

---

Exports

Functions

M.parseIso8601(datetime)

Parse an ISO 8601 date-time string to a Unix timestamp. Supports standard format (...T...Z) and AM/PM fallback format (...T...AMZ/...T...PMZ). Returns current time on parse failure.

• Parameters:
  • datetime - string - ISO 8601 formatted string (e.g., "2024-01-15T10:30
    ")
• Returns: number - Unix timestamp (via os.time)

M.timeSince(datetime)

Calculate elapsed time since an ISO 8601 date-time string.

• Parameters:
  • datetime - string - ISO 8601 formatted string
• Returns: number - Seconds elapsed since the given time

Internal Notes

• Uses pattern matching to extract year/month/day/hour/min/sec from ISO 8601
• Has AM/PM fallback pattern for broken formatting
• Logs error and returns current time if parsing fails entirely
• timeSince calls parseIso8601 internally, gets current UTC time via os.time(os.date("!*t")), then uses os.difftime

---

See Also

• utils/ - Utility Modules - Directory overview
• calltracer Reference - Related reference
• debugDraw Reference - Related reference
• filterchain Reference - Related reference
• Common Libraries Overview - Guide