Flutter伊斯兰历（印尼版）插件hijriyah_indonesia的使用

Flutter伊斯兰历（印尼版）插件hijriyah_indonesia的使用

简介

hijriyah_indonesia 是一个用于在Flutter应用中处理伊斯兰历（印尼版）的插件。它提供了将公历日期转换为伊斯兰历日期的功能，并支持多种格式化和本地化选项。本文将详细介绍该插件的使用方法，并提供一个完整的示例Demo。

使用方法

1. 获取当前伊斯兰历日期

// 假设当前公历日期是：2022年9月9日 00:27:33
var _today = Hijriyah.now();
print(_today.hYear); // 1444
print(_today.hMonth); // 2
print(_today.hDay); // 14
print(_today.getDayName()); // 14
// 获取当月的天数
print(_today.lengthOfMonth); // 30天
print(_today.toFormat("MMMM dd yyyy")); // Shafar 14 1444

2. 更改语言设置

String locale = 'id'; // 设置为印尼语
Hijriyah.setLocal(locale);

3. 转换公历日期为伊斯兰历日期

// 将公历日期转换为伊斯兰历日期
print(Hijriyah.fromDate(DateTime.parse(dateTime.toString()).toLocal()).toFormat("EEEE, dd MMMM yyyy")); // Jumat, 19 Safar 1446
print(Hijriyah.fromDate(DateTime.parse(dateTime.toString()).toLocal()).toFormat("EE, dd MMMM yyyy")); // Jum, 19 Safar 1446

4. 添加新的语言设置

Hijriyah.addLocale(locale, {
  'long': ...,
  'short': ...,
  'days': ...,
  'short_days': ...
});
Hijriyah.setLocal(locale);

5. 公历转乌玛勒库拉历（Ummalqura）

var h_date = Hijriyah.fromDate(DateTime(2018, 11, 12));
print(h_date.toString()); // 04/03/1444H
print(h_date.getShortMonthName()); // Rab
print(h_date.getLongMonthName()); // Rabiul Awwal
print(h_date.lengthOfMonth); // 29天

6. 检查日期是否有效

var _check_date = Hijriyah();
_check_date.hYear = 1439;
_check_date.hMonth = 11;
_check_date.hDay = 30;
print(_check_date.isValid()); // false -> 这个月只有29天

7. 乌玛勒库拉历转公历

var g_date = Hijriyah();
print(g_date.hijriToGregorian(1444, 7, 27)); // 2022-09-9 00:00:00.000

8. 格式化日期

var _format = Hijriyah.now();
print(_format.fullDate()); // Selasa, 14 Shaffar , 1444 h
print(_format.toFormat("mm dd yy")); // 09 14 39

9. 比较日期

// 假设当前伊斯兰历日期是：Selasa, 14 Shaffar , 1444 h
print(_today.isAfter(1440, 11, 12)); // false
print(_today.isBefore(1440, 11, 12)); // true
print(_today.isAtSameMomentAs(1440, 11, 12)); // false

完整示例Demo

以下是一个完整的Flutter应用程序示例，展示了如何使用 hijriyah_indonesia 插件将公历日期转换为伊斯兰历日期，并在界面上显示。

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

void main() {
  // 设置语言为印尼语
  Hijriyah.setLocal('id');
  runApp(const MyApp());
}

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      theme: ThemeData(
        floatingActionButtonTheme: FloatingActionButtonThemeData(
          backgroundColor: Colors.green.shade800,
        ),
        colorScheme: ColorScheme.light(primary: Colors.green.shade800),
      ),
      home: const HomeView(),
    );
  }
}

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

  [@override](/user/override)
  State<HomeView> createState() => _HomeViewState();
}

class _HomeViewState extends State<HomeView> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      backgroundColor: Colors.white,
      appBar: AppBar(
        backgroundColor: Colors.white,
        title: const Text(
          'Hijriyah Indonesia',
          style: TextStyle(color: Colors.black),
        ),
        centerTitle: true,
      ),
      body: Center(
        child: Text(
          // 将公历日期2024-08-23转换为伊斯兰历日期并格式化
          Hijriyah.fromDate(DateTime.parse('2024-08-23').toLocal())
              .toFormat("EEEE, dd MMMM yyyy"),
          style: const TextStyle(color: Colors.black, fontSize: 20),
        ),
      ),
    );
  }
}