Flutter日期时间选择器插件jiffy的使用

Jiffy简介

Jiffy 是一个适用于Flutter（Android、iOS和Web）的日期时间处理包，可以用于解析、操作、查询和格式化日期和时间。它提供了丰富的API来简化与日期时间相关的开发工作。

版本与许可证

• 版本: v6.3.2 (以实际发布为准)
• 许可证: MIT License

使用方法

安装

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

dependencies:
  jiffy: ^6.3.2

然后运行命令安装：

flutter pub get

示例代码

格式化日期

import 'package:jiffy/jiffy.dart';

void main() {
  // 格式化日期
  print(Jiffy.parse('2021/01/19').format(pattern: 'MMMM do yyyy, h:mm:ss a')); // January 1st 2021, 12:00:00 AM
  print(Jiffy.now().format(pattern: 'EEEE')); // 星期几
  print(Jiffy.now().format(pattern: 'MMM do yy')); // Mar 2nd 21
  print(Jiffy.now().format(pattern: 'yyyy [escaped] yyyy')); // 2021 escaped 2021
  print(Jiffy.now().format()); // 2021-03-02T15:18:29.922343

  // 从列表解析
  print(Jiffy.parseFromList([2020, 10, 19]).yMMMMd); // January 19, 2021

  // 从Map解析
  print(Jiffy.parseFromMap({
    Unit.year: 2020,
    Unit.month: 10,
    Unit.day: 19,
    Unit.hour: 19
  }).yMMMMEEEEdjm); // Monday, October 19, 2020 7:14 PM

  // 预设格式
  print(Jiffy.parse('19, Jan 2021', pattern: 'dd, MMM yyyy').yMMMMd); // January 19, 2021
  print(Jiffy.now().yMMMMEEEEdjm); // Tuesday, March 2, 2021 3:20 PM
}

相对时间

print(Jiffy.parse('1997/09/23').from(Jiffy.parse('2002/10/26'))); // 5 years ago
print(Jiffy.parse('1997/09/23').fromNow()); // 25 years ago

print(Jiffy.parse('1997/09/23').to(Jiffy.parse('2002/10/26'))); // in 5 years
print(Jiffy.parse('1997/09/23').toNow()); // in 25 years

操作日期

var jiffy = Jiffy.now().add(days: 1);
print(jiffy.yMMMMd); // March 3, 2021

print(Jiffy.now().subtract(days: 1).yMMMMd); // March 1, 2021

print(Jiffy.now()
  .add(hours: 3, days: 1)
  .subtract(minutes: 30, months: 1)
  .yMMMMEEEEdjm); // Wednesday, February 3, 2021 6:07 PM

print(Jiffy.parse('1997/09/23')
    .startOf(Unit.year)
    .yMMMMEEEEd); // Wednesday, January 1, 1997

print(Jiffy.parse('1997/09/23')
    .endOf(Unit.month)
    .yMMMMEEEEd); // Tuesday, September 30, 1997

查询日期

print(Jiffy.parse('1997/9/23').isBefore(Jiffy.parse('1997/9/24'))); // true

print(Jiffy.parse('1997/9/23').isAfter(Jiffy.parse('1997/9/20'))); // true

print(Jiffy.parse('1997/9/23').isSame(Jiffy.parse('1997/9/23'))); // true

print(Jiffy.parse('1997/9/23')
  .isBetween(Jiffy.parse('1997/9/20'), Jiffy.parse('1997/9/24'))); // true

多语言支持

// 获取当前语言环境，默认为 en_us
print(Jiffy.now().localeCode); // en_us

// 设置首选语言环境
await Jiffy.setLocale('fr_ca');
print(Jiffy.now().yMMMMEEEEdjm); // dimanche 26 février 2023 12 h 03

await Jiffy.setLocale('ja');
print(Jiffy.now().yMMMMEEEEdjm); // 2023年2月26日日曜日 12:02

await Jiffy.setLocale('zh_cn');
print(Jiffy.now().yMMMMEEEEdjm); // 2023年2月26日星期日 下午12:03

完整示例Demo

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Jiffy Demo')),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: <Widget>[
              Text('当前时间: ${Jiffy.now().format("yyyy-MM-dd HH:mm:ss")}', style: TextStyle(fontSize: 20)),
              SizedBox(height: 20),
              ElevatedButton(
                onPressed: () {
                  final now = Jiffy.now();
                  final tomorrow = now.add(days: 1);
                  final formatted = tomorrow.format("yyyy-MM-dd");
                  print('明天是: $formatted');
                },
                child: Text('显示明天'),
              ),
              SizedBox(height: 20),
              ElevatedButton(
                onPressed: () async {
                  await Jiffy.setLocale('zh_cn');
                  final formatted = Jiffy.now().yMMMMEEEEdjm;
                  print('当前时间（中文格式）: $formatted');
                },
                child: Text('切换到中文格式'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}

以上代码展示了如何在Flutter应用中使用Jiffy进行日期时间的解析、格式化、相对时间计算、日期操作、多语言支持等功能。希望这些内容能帮助你更好地理解和使用Jiffy插件。