Flutter时间格式化插件timeago_flutter的使用

timeago 是一个Dart库，它能够将日期转换为人类可读的文本。例如，它可以将 2020-12-12 18:30 这样的日期显示为 "now", "an hour ago" 或 "~1y" 等等。

timeago		核心库
timeago_flutter		Flutter组件

使用方法

最简单的方式是通过顶级函数 format(date) 来使用这个库：

import 'package:timeago/timeago.dart' as timeago;

main() {
    final fifteenAgo = DateTime.now().subtract(Duration(minutes: 15));

    print(timeago.format(fifteenAgo)); // 15 minutes ago
    print(timeago.format(fifteenAgo, locale: 'en_short')); // 15m
    print(timeago.format(fifteenAgo, locale: 'es')); // hace 15 minutos
}

注意事项

timeago 库默认只包含 en 和 es 两种语言的消息。要添加更多支持的语言，请使用 timeago.setLocaleMessages(..)。参见locale messages。

本库使用ISO 639-1语言代码来标识语言。更多信息请参阅ISO 639-1。

添加本地化

timeago.setLocaleMessages('fr', timeago.FrMessages()); // 添加法语消息

print(timeago.format(fifteenAgo, locale: 'es')); // environ 15 minutes

覆盖本地化或添加自定义消息

// 覆盖 "en" 本地化消息为更精确和简短的自定义消息
timeago.setLocaleMessages('en', MyCustomMessages());

// my_custom_messages.dart
class MyCustomMessages implements LookupMessages {
  @override String prefixAgo() => '';
  @override String prefixFromNow() => '';
  @override String suffixAgo() => '';
  @override String suffixFromNow() => '';
  @override String lessThanOneMinute(int seconds) => 'now';
  @override String aboutAMinute(int minutes) => '${minutes}m';
  @override String minutes(int minutes) => '${minutes}m';
  @override String aboutAnHour(int minutes) => '${minutes}m';
  @override String hours(int hours) => '${hours}h';
  @override String aDay(int hours) => '${hours}h';
  @override String days(int days) => '${days}d';
  @override String aboutAMonth(int days) => '${days}d';
  @override String months(int months) => '${months}mo';
  @override String aboutAYear(int year) => '${year}y';
  @override String years(int years) => '${years}y';
  @override String wordSeparator() => ' ';
}

Scope

为了保持库的简洁并尽量减少维护工作，我们希望：

1. 提供一个单一的 format 函数，将日期转换为人类可读的值。
2. 提供抽象接口，允许用户添加自己的语言或根据需要覆盖它们。
3. 提供由社区贡献的语言，用户可以根据需要添加这些语言，而不是默认添加所有语言。
4. 库不应该依赖任何其他依赖项。

timeago_flutter 组件

timeago_flutter 提供了以下Flutter组件：

• Timeago
• TimerRefresh
• TimerRefreshWidget

实例演示

import 'package:flutter/material.dart';
import 'package:timeago/timeago.dart' as timeago;

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Timeago Demo'),
        ),
        body: Center(
          child: Timeago(
            builder: (context, date) {
              return Text(
                timeago.format(date),
                style: TextStyle(fontSize: 20),
              );
            },
            date: DateTime.now().subtract(Duration(days: 2)),
          ),
        ),
      ),
    );
  }
}

本地开发

1. 安装Melos(链接):

   dart pub global activate melos
   

2. 启动依赖：

   melos bootstrap
   

3. 在VSCode或Webstorm中打开所需的包

实时演示

你可以在这里查看实时演示：Live Demo