Zeba Academy Date Tools 📅 #

A powerful and lightweight Flutter package for handling date and time operations easily.

Zeba Academy Date Tools provides reusable widgets and helpers including calendar UI, date picker utilities, duration formatting, and relative time formatting.

Built for modern Flutter applications with Material 3 support, null safety, and a clean developer-friendly API.

✨ Features #

✅ Calendar widget
✅ Date picker helper
✅ Time picker helper
✅ Duration formatter
✅ Relative time formatter
✅ Date range model
✅ Material 3 compatible
✅ Null safety
✅ Lightweight and easy to integrate

📦 Installation #

Add this to your pubspec.yaml:

dependencies:
  zeba_academy_date_tools: ^1.0.0

Then run:

flutter pub get

🚀 Usage #

Import the package:

import 'package:zeba_academy_date_tools/zeba_academy_date_tools.dart';

📅 Calendar Widget #

Display a calendar easily:

ZebaCalendar(
  selectedDate: DateTime.now(),

  onChanged: (date){

    print(date);

  },
)

🗓 Date Picker #

Open a date picker:

final date =
await ZebaDatePicker.pickDate(
  context,
);

print(date);

⏰ Time Picker #

Select time:

final time =
await ZebaDatePicker.pickTime(
  context,
);

print(time);

⌛ Duration Formatter #

Convert duration into readable format:

final result =
ZebaDurationFormatter.format(
  Duration(
    hours: 2,
    minutes: 30,
  ),
);

print(result);

Output:

2h 30m

🕒 Relative Time #

Show human readable time:

final text =
ZebaRelativeTime.format(
  DateTime.now()
    .subtract(
      Duration(hours: 2),
    ),
);

print(text);

Output:

2 hours ago

📆 Date Range #

Create a date range:

final range =
ZebaDateRange(
  start: DateTime(2026,1,1),
  end: DateTime(2026,1,10),
);


print(
 range.duration.inDays
);

Output:

9

🧪 Testing #

Run package tests:

flutter test

Analyze code:

flutter analyze

📂 Project Structure #

lib/
 ├── zeba_academy_date_tools.dart
 │
 └── src/
     ├── widgets/
     │    └── calendar_view.dart
     │
     ├── picker/
     │    └── date_picker_helper.dart
     │
     ├── formatters/
     │    ├── duration_formatter.dart
     │    └── relative_time.dart
     │
     └── models/
          └── date_range.dart

👨‍💻 About Me #

✨ I’m Sufyan bin Uzayr, an open-source developer passionate about building and sharing meaningful projects.

Learn more about my work:

🌐 sufyanism.com
💼 LinkedIn

🎓 Zeba Academy #

Your all-in-one learning hub! #

🚀 Explore courses and resources in coding, tech, and development.

Build practical skills through tutorials, real-world projects, and hands-on learning.

💻 Level up your development journey today!

Zeba Academy is a learning platform dedicated to:

• Coding
• Technology
• Software Development

Visit:

➡ Main website:
https://zeba.academy

➡ Courses and resources:
https://code.zeba.academy

➡ YouTube tutorials:
https://www.youtube.com/@zeba.academy

➡ Instagram:
https://www.instagram.com/zeba.academy/

🤝 Contributing #

Contributions are welcome!

Steps:

1. Fork the repository

2. Create your feature branch

git checkout -b feature/new-feature

3. Commit changes

git commit -m "Add new feature"

4. Push branch

git push origin feature/new-feature

5. Create a Pull Request

📜 License #

This project is licensed under the GNU General Public License v3.0.

You are free to use, modify, and distribute this software under the terms of the GPL-3.0 license.

See the full license:

https://www.gnu.org/licenses/gpl-3.0.html

❤️ Support #

If this package helps your project, consider giving it a ⭐ on GitHub.

Thank you for using Zeba Academy Date Tools 🚀