Search packages, repositories and app categories

Package detailsv1.2.86

full_calender

The Full Calendar Flutter Library facilitates seamless conversion between solar, lunar calendars and Julian days, with a focus on the Vietnamese lunar calendar system.

AndroidiOSWebmacOSWindowsLinux
30-day downloads
195
Likes
47
Pub points
160

Install package

flutter pub add full_calender

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

The Full Calendar Flutter Library enables smooth conversion between solar, lunar, and Julian calendars, with specialized support for the Vietnamese lunar calendar system. It provides accurate date calculations and is ideal for applications requiring culturally specific calendar functionality. The library is compatible across all major platforms, including Android, iOS, Web, macOS, Windows, and Linux, making it a versatile choice for internationalized apps. Its integration via Flutter Pub is straightforward, ensuring quick setup and reliable performance.

Use cases

  • Vietnamese cultural event planning
  • Lunar festival date calculation
  • Calendar-based reminder systems
  • International date conversions
  • Historical date analysis
  • Multi-calendar display in apps

Key features

  • Vietnamese lunar calendar support
  • Solar-lunar-Julian conversions
  • Cross-platform compatibility
  • Accurate date arithmetic
  • Easy Flutter Pub integration
  • Support for historical and future dates

Suitable for

  • Apps targeting Vietnamese users
  • Cultural or religious event planners
  • Educational tools with calendar features
  • International date conversion utilities
  • Developers needing lunar calendar logic

Considerations

  • Limited to solar/lunar/Julian systems
  • No built-in UI components
  • Requires manual handling of calendar displays
  • Dependent on accurate input dates
  • Not optimized for high-frequency updates
  • No localization beyond Vietnamese context

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

💰 Sponsor for my work:
  • Momo: Tài trợ qua MoMo

Full Calendar Flutter Library

Welcome to the Full Calendar Library! This library provides a comprehensive set of tools for working with lunar dates, stems, branches, and more, making it easy to integrate traditional calendar features into your Flutter applications.

Features

  • Lunar Date Conversion: Easily convert between solar and lunar dates.
  • Number of Julian day Conversion: Easily convert solar and lunar dates to number of Julian day.
  • Stems and Branches: Retrieve stems and branches for years, months, days, and hours.
  • Multilingual Support: Get names and representations in various languages.
  • Lucky Day and Hour Detection: Find out if a day or hour is considered lucky based on lunar calendar principles.

Getting Started

To use this library, add the following dependency to your pubspec.yaml file:

dependencies:
  full_calender: 

Then run:

$ flutter pub get

Import the library in your Dart code:

import 'package:full_calender/full_calender.dart';

Usage

Lunar Date Conversion

// Convert lunar date to solar date
final lunarDate = LunarDateTime(year: 2023, month: 11, day: 10);
final solarDate = FullCalenderExtension.convertLunarDateToSolarDate(lunarDate);
print(solarDate); // Output: 2023-12-28

Stems and Branches

// Get stem and branch for a specific year
final stemBranchOfYear = StemBranch.year(2023);
print(stemBranchOfYear.name(LanguageName.vietNam)); // Output: Kỷ Hợi

Lucky Day and Hour Detection

// Check if a specific day is considered lucky
final luckyDay = FullCalender(date: DateTime(2023, 12, 28)).lunarDate.isLuckyDay;
print(luckyDay); // Output: true

// Get a list of lucky hours for a specific date
final luckyHours = FullCalender(date: DateTime(2023, 11, 20)).lunarDate.listLuckyHours;
print(luckyHours); // Output: [true, true,false,true,false,false,true,false,true,true,false,false]

Stems and Branches

// Get stem and branch for a specific year
final stemBranchOfYear = StemBranch.year(2023);
print(stemBranchOfYear.name(LanguageName.vietNam)); // Output: Kỷ Hợi

For more examples, check out the example directory.

Issues and Feedback Please file issues or provide feedback on our GitHub repository.

Categories

Source repository

Projects using this package

No data available yet.