Flutter日期格式化插件 date_format_helper 的使用

date_format_helper 是一个用于处理日期和时间的Flutter工具包。它提供了简单的方法来格式化、解析日期和时间，并提取特定的日期和时间细节。

特性

日期格式化

• 自定义格式（例如 dd/MM/yyyy，hh:mm a）。
• 完整和简短的日期样式。
• 时间戳和ISO-8601格式。

日期解析

• 使用自定义格式将字符串转换为 DateTime 对象。

日期细节

• 提取日名称、月名称、周数、季度等。

相对时间

• 获取类似“2天前”或“刚刚”的人类可读字符串。

闰年检查

• 验证给定年份是否为闰年。

安装

在您的 pubspec.yaml 文件中添加以下内容：

dependencies:
  date_format_helper: ^0.0.3

然后运行：

flutter pub get

导入

在您的 Dart 文件中导入该包：

import 'package:date_format_helper/date_format_helper.dart';

使用示例

以下是一个完整的示例 demo，展示了如何使用 date_format_helper 包中的各种方法：

import 'package:date_format_helper/date_format_helper.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 Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  DateTime now = DateTime.now();

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
      ),
      body: Center(
        child: SingleChildScrollView(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: <Widget>[
              Text('Full Date: ${DateFormatHelper.formatFullDate(now)}'),
              Text('\nShort Date: ${DateFormatHelper.formatShortDate(now)}'),
              Text('\n12-hour Time: ${DateFormatHelper.formatTime12Hour(now)}'),
              Text('\n24-hour Time: ${DateFormatHelper.formatTime24Hour(now)}'),
              Text('\nTimestamp: ${DateFormatHelper.formatTimestamp(now)}'),
              Text('\nISO-8601: ${DateFormatHelper.formatISO(now)}'),
              Text('\nRelative Time: ${DateFormatHelper.formatRelative(now.subtract(const Duration(days: 2)))}'),
              Text('\nDay Name: ${DateFormatHelper.getDayName(now)}'),
              Text('\nShort Day Name: ${DateFormatHelper.getShortDayName(now)}'),
              Text('\nDay Number: ${DateFormatHelper.getDayNumber(now)}'),
              Text('\nMonth Name: ${DateFormatHelper.getMonthName(now)}'),
              Text('\nShort Month Name: ${DateFormatHelper.getShortMonthName(now)}'),
              Text('\nYear: ${DateFormatHelper.getYear(now)}'),
              Text('\nWeek Number: ${DateFormatHelper.getWeekNumber(now)}'),
              Text('\nQuarter: ${DateFormatHelper.getQuarter(now)}'),
              Text('\nIs Leap Year: ${DateFormatHelper.isLeapYear(now.year)}'),
            ],
          ),
        ),
      ),
    );
  }
}