📢 smart_date_formatter v2.0.0 — The Complete Flutter DateTime Toolkit

[harshyadavDeveloper]

📢 smart_date_formatter v2.0.0 Released!

The complete Flutter DateTime toolkit — Format • Parse • Calculate •
Localize • Widget-Ready • Analytics • Full Calendar

We're excited to announce v2.0.0 of smart_date_formatter —
the most comprehensive DateTime package for Flutter!

---

✨ What is smart_date_formatter?

Stop writing repetitive date formatting code in every project.
One package — everything you need.

// Before — 3 packages + 120 lines every project 😩
dependencies:
  timeago: ^3.6.0
  intl: ^0.18.0
  // + manual utility functions

// After — one package 🚀
dependencies:
  smart_date_formatter: ^2.0.0

---

🚀 Key Features

⏱️ Relative Time

DateTime.now().subtract(Duration(hours: 2)).timeAgo  // "2 hours ago"
DateTime.now().add(Duration(days: 1)).timeAgo         // "Tomorrow"
DateTime.now().subtract(Duration(days: 9)).timeAgo    // "Last week"

🎨 Custom Format

DateTime.now().format('dd-MM-yyyy')    // "15-06-2024"
DateTime.now().toReadable              // "Saturday, 15 June 2024"
DateTime.now().to12Hour                // "02:30 PM"

🌍 16 Languages

date.timeAgoIn(SdfLocale.hi)   // "2 घंटे पहले"
date.timeAgoIn(SdfLocale.mr)   // "2 तास पूर्वी"
date.timeAgoIn(SdfLocale.bn)   // "2 ঘন্টা আগে"
date.timeAgoIn(SdfLocale.de)   // "2 Stunden her"
date.timeAgoIn(SdfLocale.ja)   // "2 時間前"

🔍 Smart Parser

SmartParser.parse("tomorrow")       // DateTime
SmartParser.parse("next monday")    // DateTime
SmartParser.parse("in 3 days")      // DateTime
SmartParser.parse("कल")             // DateTime (Hindi!)
SmartParser.parse("उद्या")          // DateTime (Marathi!)

⏱️ Auto-Refreshing Widgets

// No setState, no Timer — just works!
TimeAgoText(
  date: message.sentAt,
  locale: SdfLocale.hi,
  refreshRate: Duration(seconds: 30),
)

CountdownText(
  target: saleEndsAt,
  format: '{hh}:{mm}:{ss}',
  onFinished: () => hideSaleBanner(),
)

🗓️ Full Calendar Widget (NEW in v2.0.0!)

SmartCalendar(
  events: [
    CalendarEvent(
      date: DateTime.now(),
      title: 'Team Meeting',
      color: Colors.blue,
    ),
  ],
  initialView: CalendarView.month, // month, week, day
  markerStyle: EventMarkerStyle.dot,
  onDateSelected: (date, events) => print(date),
)

📊 Analytics

// Habit tracking
StreakCalculator.currentStreak(dates)    // 7
StreakCalculator.longestStreak(dates)    // 21
StreakCalculator.completionRate(dates, start: s, end: e) // 0.8

// Group by time period
DateGrouper.byMonth(activityDates)
DateGrouper.mostActiveWeekday(dates)    // "Monday"
DateGrouper.averageGap(dates)           // Duration(days: 2)

🎄 Holiday Support

date.isHoliday(holidays: HolidayHelper.indianHolidays(2024))
date.addWorkingDaysWithHolidays(5, holidays: holidays)

🔁 Recurrence

RecurrenceHelper.weekly(start: date, count: 8)
RecurrenceHelper.monthly(start: date, until: endDate)

---

📦 Installation

dependencies:
  smart_date_formatter: ^2.0.0

flutter pub get

---

🌐 Live Playground

Try every feature interactively — no installation needed!

👉 Open Interactive Playground

---

📚 Resources

Resource	Link
📦 pub.dev	smart_date_formatter
💻 GitHub	harshyadavDeveloper/smart_date_formatter
🐛 Issues	Report a bug
📖 README	Full API Reference

---

🗺️ Full Version History

Version	Highlights
0.0.1	Initial — timeAgo, calendar, shortTimestamp
0.1.0	Custom format(), toReadable, toISO
0.5.0	Date calculations, working days
0.9.0	6 languages + SmartParser
1.0.0	✅ Stable — TimeAgoText, CountdownText, DateRangeHelper
1.1.0	Quarter, isLeapYear, isSameDay, copyWith
1.2.0	16 languages 🌍
1.2.1	Code quality + modular example
1.3.0	DateBadge, SmartDateText, RelativeDateBuilder
1.4.0	HolidayHelper + RecurrenceHelper
1.5.0	StreakCalculator + DateGrouper 📊
1.6.0	Hindi/Marathi SmartParser 🇮🇳
2.0.0	🎉 SmartCalendar — Full calendar widget

---

🔜 What's Next?