Flutter日历插件flutter_mmcalendar的使用

Flutter日历插件flutter_mmcalendar的使用

安装 💻

为了开始使用flutter_mmcalendar，你必须在机器上安装Flutter SDK。

在你的pubspec.yaml文件中添加flutter_mmcalendar依赖：

dependencies:
  flutter_mmcalendar:

然后运行以下命令来安装它：

flutter packages get

特性

• Myanmar Date
• Western Date
• Astrological Information
• Holidays - 包括缅甸泼水节和其他节日。
• MoonPhase小部件。

使用

首先导入包：

import 'package:flutter_mmcalendar/flutter_mmcalendar.dart';

示例用法

默认配置：

final mmCalendar = MmCalendar(
  config: MmCalendarConfig.defaultConfig(),
);

英语语言配置：

final mmCalendar = MmCalendar(
  config: MmCalendarConfig.englishLanguage(),
);

特定语言和日历类型：

final mmCalendar = MmCalendar(
  config: const MmCalendarConfig(
    calendarType: CalendarType.gregorian,
    language: Language.myanmar,
  ),
);

使用示例：

// 获取指定日期的缅甸日期
final myanmarDate = mmCalendar.fromDate(2023, 10, 19);

可用配置：

• MmCalendarConfig.defaultConfig()
• MmCalendarConfig.myanmarLanguage()
• MmCalendarConfig.zawgyiLanguage()
• MmCalendarConfig.englishLanguage()
• MmCalendarConfig.monLanguage()
• MmCalendarConfig.karenLanguage()
• MmCalendarConfig.taiLanguage()

可用语言：

• english
• myanmar - 缅甸语Unicode
• zawgyi - 缅甸语Zawgyi
• mon
• karen
• tai

其他用法：

// 日期转换方法
final myanmarDate = mmCalendar.fromDateTime(DateTime.now());
mmCalendar.fromDate(2023, 7, 27);
mmCalendar.fromDateAndTime(2023, 7, 27, 10, 30, 01);
mmCalendar.fromJulian(2456599);
final westernDate = mmCalendar.getWesternDateFromJulianDay(2456599);

/// 星座信息
final astro = myanmarDate.astro;
final astroByLanguage = myanmarDate.getAstro(
  languageCatalog: LanguageCatalog.myanmar(),
);
astro.getMahabote();

// 所有节假日
List<String> holidays = myanmarDate.holidays;

final resultStr = myanmarDate.formatByPatternAndLanguage(
  pattern: MyanmarDateFormat.simple,
  langCatalog: mmCalendar.languageCatalog,
);
// 输出: သာသနာနှစ် ၂၅၆၇ ခု, မြန်မာနှစ် ၁၃၈၅ ခု, သီတင်းကျွတ် လပြည့်  ရက် တနင်္ဂနွေနေ့
// (或)

final resultStr = myanmarDate.formatByPatternAndLanguage(
    pattern: 'S s k, B y k, M p f r En',
    langCatalog: LanguageCatalog(language: Language.english),
);
// 输出: Sasana Year 2567 , Myanmar Year 1385 , Thadingyut full moon   Sunday

缅甸日期模式

缅甸日期格式由日期模式字符串指定。以下是定义的模式字母（‘S’, ‘s’, ‘B’, ‘y’, ‘k’, ‘M’, ‘p’, ‘f’, ‘E’, ‘n’, ‘r’ 是保留的）：

// S s k, B y k, M p f r En
MyanmarDateFormat.simple
// S
MyanmarDateFormat.sasanaYear
// s
MyanmarDateFormat.buddhistEra
// B
MyanmarDateFormat.burmeseYear
// y
MyanmarDateFormat.myanmarYear
// k
MyanmarDateFormat.ku
// M
MyanmarDateFormat.monthInYear
// p
MyanmarDateFormat.moonPhase
// f
MyanmarDateFormat.fortnightDay
// E
MyanmarDateFormat.dayNameInWeek
// n
MyanmarDateFormat.nay
// r
MyanmarDateFormat.yat

星座信息

final mmCalendar = MmCalendar(
  config: MmCalendarConfig.myanmarLanguage(),
);

final myanmarDate = mmCalendar.fromDate(2023, 10, 19);
final astro = myanmarDate.astro;

// အမြိတ္တစုတ်
final amyeittasote = astro.getAmyeittasote();

// ရက်ရာဇာ, ပြဿဒါး, မွန်းလွဲပြဿဒါး
final astrologicalDay = astro.getAstrologicalDay();

// "Binga", "Atun", "Yaza", "Adipati", "Marana", "Thike", "Puti"
final mahabote = astro.getMahabote();

// မဟာရက်ကြမ်း
final mahayatkyan = astro.getMahayatkyan();

// "West", "North", "East", "South"
final nagahle = astro.getNagahle();

// နဂါးပေါ်
final nagapor = astro.getNagapor();

// "Ogre", "Elf", "Human"
final nakhat = astro.getNakhat();

// ဥပုသ်
final sabbath = astro.getSabbath();

// ရှမ်းရက်
final shanyat = astro.getShanyat();

// သမားညို
final thamanyo = astro.getThamanyo();

// သမားဖြူ
final thamaphyu = astro.getThamaphyu();

// ဝါရမိတ္တုကြီး
final warameittugyi = astro.getWarameittugyi();

// ဝါရမိတ္တုငယ်
final warameittunge = astro.getWarameittunge();

// ရက်ပုပ်
final yatpote = astro.getYatpote();

// ရက်ယုတ်မာ
final yatyotema = astro.getYatyotema();

// "ပုဿနှစ်", "မာခနှစ်", "ဖ္လကိုန်သံဝစ္ဆိုဝ်ရနှစ်", "စယ်နှစ်", "ပိသျက်နှစ်", "စိဿနှစ်", "အာသတ်နှစ်", "သရဝန်နှစ်",
// "ဘဒ္ဒြသံဝစ္ဆုံရ်နှစ်", "အာသိန်နှစ်", "ကြတိုက်နှစ်", "မြိက္ကသိုဝ်နှစ်"
final yearName = astro.getYearName();

你还可以通过调用以is前缀的属性来检查这些日子是否符合某些条件。例如：

// 它将返回true或false
final isAmyeittasote = astro.isAmyeittasote;

月相小部件

MoonPhaseWidget(
  date: DateTime.now(),
  size: 50,
),

概念参考资源

算法、程序和缅甸日历计算

• 算法、程序和缅甸日历计算 (Dr Yan Naing Aye)

C++ 和 JavaScript 实现

• C++ 和 JavaScript 实现

Java 库实现

• Java 库实现

完整示例代码

以下是一个完整的示例代码，展示了如何使用flutter_mmcalendar插件：

import 'package:example/pages/home_page.dart';
import 'package:flutter/material.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter MMCalendar',
      debugShowCheckedModeBanner: false,
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const HomePage(),
    );
  }
}

import 'package:flutter/material.dart';
import 'package:flutter_mmcalendar/flutter_mmcalendar.dart';

class HomePage extends StatefulWidget {
  const HomePage({super.key});

  [@override](/user/override)
  _HomePageState createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  final mmCalendar = MmCalendar(
    config: MmCalendarConfig.defaultConfig(),
  );

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Flutter MMCalendar Example'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text(
              '当前日期:',
              style: TextStyle(fontSize: 20),
            ),
            FutureBuilder<DateTime>(
              future: mmCalendar.fromDateTime(DateTime.now()),
              builder: (context, snapshot) {
                if (snapshot.hasData) {
                  return Text(
                    '缅甸日期: ${snapshot.data!.year} 年 ${snapshot.data!.month} 月 ${snapshot.data!.day} 日',
                    style: TextStyle(fontSize: 20),
                  );
                } else if (snapshot.hasError) {
                  return Text('${snapshot.error}');
                }
                return CircularProgressIndicator();
              },
            ),
            SizedBox(height: 20),
            MoonPhaseWidget(
              date: DateTime.now(),
              size: 50,
            ),
          ],
        ),
      ),
    );
  }
}