Jiffy 是一个 Dart 语言库，用于日期和时间的解析、操作和格式化。它借鉴了 JavaScript 中流行的 Moment.js 库的 API。以下是如何在 Flutter 项目中使用 Jiffy 库的一些基本示例。
解析和格式化日期：
// 解析指定日期
var jiffy1 = Jiffy("2023-04-28", "yyyy-MM-dd");
print(jiffy1.yMMMEd); // e.g., Fri, Apr 28, 2023
// 使用默认格式解析当前日期和时间
var jiffy2 = Jiffy();
print(jiffy2.format("yyyy-MM-dd hh:mm")); // 会打印当前日期和时间
// 解析并本地化（需要提前初始化本地化配置）
Jiffy.locale("zh_cn");
var jiffy3 = Jiffy("2023-04-28");
print(jiffy3.yMMMMEEEEd); // e.g., 2023年4月28日星期五
日期操作：
// 在当前日期添加时间
jiffy2.add(days: 1, months: 1);
// 在当前日期减去时间
jiffy2.subtract(days: 1, months: 1);
// 改变 Jiffy 对象的时间
jiffy2.dateTime = DateTime(2024, 1, 1);
日期比较：
// 检查一个日期是否在另一个日期之前
bool isBefore = jiffy1.isBefore(jiffy2);
// 检查一个日期是否在另一个日期之后：
bool isAfter = jiffy1.isAfter(jiffy2);
// 检查一个日期是否与另一个日期相同
bool isSame = jiffy1.isSame(jiffy2);
// 检查一个日期是否在另一个日期之前，或者是否相同
bool isSameOrBefore = jiffy1.isSameOrBefore(jiffy2);
// 检查一个日期是否在另一个日期之后，或者是否相同
bool isSameOrAfter = jiffy1.isSameOrAfter(jiffy2);
日期差异：
// 获取两个日期之间的差异（天）
var difference = jiffy1.diff(jiffy2, Units.DAY);
print(difference); // 将会打印天数的差异
// 获取两个时间的差异，返回 Duration 对象
Duration duration = jiffy1.diff(jiffy2);
print(duration.inHours); // 将会打印小时数的差异
链式调用：
// 你可以链式使用 Jiffy 的方法
jiffy1.add(days: 1).subtract(months: 1).startOf(Units.DAY);
print(jiffy1.yMMMMd); // 会修改日期后打印新的日期格式
开始与结束时间：
// 获取月份的开始时间
Jiffy startOfMonth = Jiffy([2023, 4, 28]).startOf(Units.MONTH);
print(startOfMonth.yMMMMd); // 打印月初日期
// 获取月份的结束时间
Jiffy endOfMonth = Jiffy([2023, 4, 28]).endOf(Units.MONTH);
print(endOfMonth.yMMMMd); // 打印月末日期
本地化：
要使用本地化，需要先导入相应的语言包。例如：
import 'package:jiffy/locale/zh_cn.dart';
// 在初始化你的应用或者某个功能之前设置
Jiffy.locale('zh_cn');
// 设置之后，所有的 Jiffy 对象或字符串将以中文格式显示
var jiffy4 = Jiffy("2023-04-28", "yyyy-MM-dd");
// 按照中文格式输出
print(jiffy4.format("MMM do yyyy")); // 打印出的将是中文日期格式
相对时间 (fromNow)：
// 比较日期与当前时间的相对距离
Jiffy futureJiffy = Jiffy()..add(days: 3);
print(futureJiffy.fromNow()); // "in 3 days"
Jiffy pastJiffy = Jiffy()..subtract(days: 1);
print(pastJiffy.fromNow()); // "a day ago"
自定义格式：
// 自定义解析和显示格式
var jiffy5 = Jiffy("2023-04-28T20:13:45.000Z", "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'");
print(jiffy5.format("yyyy-MM-dd h:mm a")); // 转换成自定义格式
处理时区和UTC时间：
// 按照 UTC 时间创建 Jiffy 对象
var jiffy6 = Jiffy("2023-04-28T20:13:45Z").utc();
print(jiffy6.local().format("yyyy-MM-dd hh:mm")); // 转换成本地时间格式
// 将当前 Jiffy 对象转换为 UTC 时间
var jiffy7 = Jiffy().utc();
print(jiffy7.format("yyyy-MM-dd HH:mm")); // UTC 时间格式
使用 Unix 时间戳：
// 从 Unix 时间戳创建 Jiffy 对象
var jiffyUnix = Jiffy.unix(1674739200); // 参数是秒数
print(jiffyUnix.format("MMM do yy")); // 格式化 Unix 时间
// 获取当前时间的 Unix 时间戳
var nowUnix = Jiffy().unix();
print(nowUnix); // 打印当前时间的 Unix 时间戳（秒数）
使用 ISO8601：
// 从 ISO8601 字符串创建 Jiffy 对象
var jiffyISO8601 = Jiffy("2023-04-28T20:13:45.000Z");
print(jiffyISO8601.format("yyyy-MM-dd hh:mm:ss")); // 格式化 ISO8601 字符串
日历时间：
// 获取日历时间（相对于当前时间的友好表示）
Jiffy jiffyCalendar = Jiffy()..subtract(hours: 2, minutes: 30);
print(jiffyCalendar.calendar()); // "Today at XX:XX PM/AM"
// 可以显式指定“现在”的时间
Jiffy now = Jiffy();
print(jiffyCalendar.calendar(now)); // 使用自定义“现在”计算日历时间
Jiffy 函数和方法更多的参数、选项和配置可以在库的官方文档中找到：Jiffy pub.dev Documentation。这个文档包含了 Jiffy 的所有 API 详细信息、例子和额外说明，非常适合作为查阅和学习的资源。
