Flutter伊朗历日历插件jalali_calendar的使用

JalaShamsi 日历插件（DatePicker 和 TimePicker）

简介

本插件提供用于伊朗历（Jalali/Shamsi）的日历、日期选择器和日期转换功能。适用于Android和iOS平台。

功能展示

使用方法

在 pubspec.yaml 中添加依赖

dependencies:
  jalali_calendar: <最新版本>

导入库

在需要使用的 Dart 文件中导入以下库：

import 'package:jalali_calendar/jalali_calendar.dart';
import 'package:persian_date/persian_date.dart';

显示日历并获取日期

可以通过调用 jalaliCalendarPicker() 方法来显示日历，并获取用户选择的日期。如果希望返回的日期为公历格式，可以在调用该方法时设置 convertToGregorian 参数为 true。

返回伊朗历日期

Future _selectDate() async {
  String picked = await jalaliCalendarPicker(context: context);
  if (picked != null) setState(() => _value = picked.toString());
  print(_value);
}

返回公历日期

Future _selectDate() async {
  String picked = await jalaliCalendarPicker(context: context, convertToGregorian: true);
  if (picked != null) setState(() => _value = picked.toString());
  print(_value);
}

显示时间选择器

可以设置一些参数来显示时间选择器。例如：

• showTimePicker: 设置为 true 来显示时间选择器。
• hore24Format: 设置为 true 来以24小时制显示时间。
• initialTime: 通过 TimeOfDay 设置初始时间。

使用日期选择器

要显示日期选择器，需要指定一些参数，如最小年份 (minYear) 和最大年份 (maxYear)。还需要指定确认按钮 (confirm) 和取消按钮 (cancel) 的文本。

完整的日期选择器示例

DatePicker.showDatePicker(
  context,
  minYear: 1300,
  maxYear: 1450,
  confirm: Text(
    '确定',
    style: TextStyle(color: Colors.red),
  ),
  cancel: Text(
    '取消',
    style: TextStyle(color: Colors.cyan),
  ),
  dateFormat: _format,
  onChanged: (year, month, day) {
    if (!showTitleActions) {
      _changeDatetime(year, month, day);
    }
  },
  onConfirm: (year, month, day) {
    _changeDatetime(year, month, day);
    _valuePiker = "完整日期 : $_datetime  \n 年 : $year \n 月 : $month \n 日 : $day";
  }
);

void _changeDatetime(int year, int month, int day) {
  setState(() {
    _datetime = '$year-$month-$day';
  });
}

使用日期转换器

首先需要导入 persian_date 库：

import 'package:persian_date/persian_date.dart';

完整的日期转换器示例

// 创建一个日期对象
PersianDate pDate = PersianDate(gregorian: "1989-01-29");
print("当前日期 ${pDate.getDate}");

// 获取当前日期
PersianDate persianDate = PersianDate();
print("当前日期 ${persianDate.now}");
print(persianDate.hour);
print("年 ${persianDate.year}");
print("是否节假日 ${persianDate.isHoliday}");
print("星期几 ${persianDate.weekdayname}");
print(persianDate.monthname); // 月份名称
print(persianDate.month); // 月份
print(persianDate.day); // 日期
print(persianDate.hour); // 小时
print(persianDate.minute); // 分钟
print(persianDate.second); // 秒
print(persianDate.millisecond); // 毫秒
print(persianDate.microsecond); // 微秒

print("将公历转为伊朗历 ${persianDate.gregorianToJalali("2019-02-20T00:19:54.000Z","yyyy-m-d hh:nn")}");
print("将伊朗历转为公历 ${persianDate.jalaliToGregorian("1368-05-30 19:54", "yyyy-m-d hh:nn")}");

支持的日期格式

支持的日期格式包括：

"2012-02-27 13:27:00"
"2012-02-27 13:27:00.123456z"
"2012-02-27 13:27:00,123456z"
"20120227 13:27:00"
"20120227T132700"
"20120227"
"+20120227"
"2012-02-27T14Z"
"2012-02-27T14+00:00"
"-123450101 00:00:00 Z": 在公元前12345年
"2002-02-27T14:00:00-0500": 相当于 "2002-02-27T19:00:00Z"