simple_date_time 1.0.0

A lightweight Flutter utility to format date and time safely with presets.

simple_date_time

A lightweight Flutter utility to parse and format date & time safely using simple functions and preset enums.

Designed to avoid common backend date issues and reduce repetitive boilerplate across Flutter projects.

---

✨ Features

• ✅ Format date from String
• ✅ Format date from DateTime
• ✅ Convert String → DateTime
• ✅ Tiny, dependency-light package
• ✅ Preset enums for date & time formats
• ✅ Support for custom date format strings
• ✅ Safe parsing (no crashes)
• ✅ No intl dependency

---

🚀 Usage

Import the package:

import 'package:simple_date_time/simple_date_time.dart';

---

📅 Format Date from String (Preset)

SimpleDateTime.formatStringDateTime(
  date: '2025-11-18 22:30:45.000',
  dateFormatPreset: SimpleDateFormat.ddMMMyyyy,
);

Output

18 Nov 2025

---

🎨 Format Date from String (Custom Format)

Use customFormat when you want full control over the date pattern.

SimpleDateTime.formatStringDateTime(
  date: '2025-11-18 22:30:45.000',
  customFormat: 'EEEE, dd MMM yyyy',
);

Output

Tuesday, 18 Nov 2025

---

⏰ Format Date + Time from String

SimpleDateTime.formatStringDateTime(
  date: '2025-11-18 22:30:45.000',
  dateFormatPreset: SimpleDateFormat.ddMMMyyyy,
  timeFormatPreset: SimpleTimeFormat.hhMmAmPm,
  includeTime: true,
);

Output

18 Nov 2025 10:30 PM

---

📆 Format from DateTime

SimpleDateTime.formatDateTime(
  dateTime: DateTime.now(),
  dateFormatPreset: SimpleDateFormat.ddMMMyyyy,
  timeFormatPreset: SimpleTimeFormat.hhMmAmPm,
  includeTime: true,
);

---

🔄 Convert String to DateTime

final dateTime = SimpleDateTime.toDateTime(
  date: '18-11-2025',
  inputFormat: 'dd-MM-yyyy',
);

Returns DateTime? Returns null if parsing fails.

---

🧩 Date Format Presets

enum SimpleDateFormat {
  yyyyMMdd,      // 2025-11-18
  ddMMyyyy,      // 18-11-2025
  ddMMMyyyy,     // 18 Nov 2025
  mMMddyyyy,     // Nov 18, 2025
  yyyyMMddSlash, // 2025/11/18
}

---

⏱ Time Format Presets

enum SimpleTimeFormat {
  hhMmAmPm, // 10:30 AM
  hhMm,     // 10:30
  hHmm,     // 22:30
  hHmmss,   // 22:30:45
}

---

🌍 Timezone Handling

• String-based APIs automatically convert to local time
• DateTime APIs support toLocal toggle

SimpleDateTime.formatDateTime(
  dateTime: utcDateTime,
  toLocal: false,
);

---

🛡 Error Handling

• Invalid input → returns empty string ('')
• Invalid parsing → returns null
• No uncaught exceptions

Safe for production use.

---

📌 When to Use

• Backend date strings
• API responses
• Logs, orders, chats, timelines
• Replacing repeated DateFormat code

---

License

MIT License © 2026 Pankaj Ram

---

❤️ Author

Built with care for real-world Flutter apps.

Happy coding 🚀