DateTime - Formatting Extensions

Convert DateTime objects to human-readable ‘time ago’ strings and localized formats, including short month names and ISO week numbers.

1. 🕒 Relative Time

   timeAgo() · String

   Converts a past date into a human-readable “time ago” string (e.g., “2 months ago” or “Just now”).

   final past = DateTime.now().subtract(const Duration(hours: 3));
   print(past.timeAgo()); // "3 hours ago"
   

   timeUntil() · String

   Converts a future date into a human-readable “time until” string (e.g., “in 5 days” or “Just now”).

   final future = DateTime.now().add(const Duration(hours: 5));
   print(future.timeUntil()); // "in 5 hours"
   

   slashedDate() · String

   Formats the date into the slash-separated ‘dd/MM/yyyy’ style.

   print(DateTime(2025, 12, 31).slashedDate()); // "31/12/2025"
   
2. 🌐 Localization (`intl` dependency required)

   monthName() · String

   Gets the full name of the month (e.g., “January”, “December”) based on the system locale.

   print(DateTime(2025, 12, 1).monthName()); // "December"
   

   monthNameShort() · String

   Gets the abbreviated name of the month (e.g., “Jan”, “Dec”) based on the system locale.

   print(DateTime(2025, 12, 1).monthNameShort()); // "Dec"
   

   dayName() · String

   Gets the full name of the day of the week (e.g., “Monday”, “Sunday”) based on the system locale.

   print(DateTime(2025, 12, 1).dayName()); // "Monday"
   

   dayNameShort() · String

   Gets the abbreviated name of the day of the week (e.g., “Mon”, “Sun”) based on the system locale.

   print(DateTime(2025, 12, 1).dayNameShort()); // "Mon"
   
3. 📊 Calendar Math

   weekNumber() · int

   Calculates the ISO 8601 week number (1-53) for the given date.

   // January 1st is typically Week 1
   print(DateTime(2025, 1, 1).weekNumber()); // 1