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
  1. Commit changes
git commit -m "Add new feature"
  1. Push branch
git push origin feature/new-feature
  1. 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 🚀

Libraries

zeba_academy_date_tools