flutter pub add get_time_ago根據套件公開資料產生的選型評估，僅供參考。
一個輕量級的 Dart 套件，可將 DateTime 物件轉換為人類可讀的「多久以前」字串，例如「20 秒前」或「7 小時前」。它簡化了應用程式中相對時間戳的顯示，透過以自然、對話式格式呈現時間來提升使用者體驗。此套件支援多個平台，並容易與 Flutter 專案整合。
以下為關聯原始碼儲存庫的 README 原文快照，最新內容請造訪原始碼儲存庫。
A Dart package that converts and formats DateTime objects into human-readable 'time ago' strings, such as '20 seconds ago', 'a minute ago', or '7 hours ago'. This package provides an easy way to display relative time differences in your Flutter or Dart applications. It supports various time units (seconds, minutes, hours, days, etc.) and automatically adjusts the format based on how recent the event occurred. Ideal for displaying timestamps in news feeds, social media posts, or chat messages.
[
[
[
justNow Method in Messages InterfaceIn version 2.0.0, a new method justNow(int seconds) has been added to the Messages interface. This method is responsible for providing a custom message when the elapsed time is less than 15 seconds.
If you have implemented any custom locales by extending the Messages interface, you will need to update your implementation to include the new justNow method. Failing to implement this method will result in compilation errors.
Before:
class MyCustomMessages implements Messages {
@override
String prefixAgo() => '';
@override
String suffixAgo() => 'ago';
// Implement the other methods here...
}
After (Version 2.0.0):
class MyCustomMessages implements Messages {
@override
String prefixAgo() => '';
@override
String suffixAgo() => 'ago';
@override
String justNow(int seconds) => 'just now'; // New method
// Implement the other methods here...
}
This section explains the breaking change, the impact it has on custom implementations, and provides an example of how to update existing code to comply with the new changes in version ^2.0.0.
Add get_time_ago as a dependency in your pubspec.yaml file.
dependencies:
get_time_ago: ^latest_version
Format any DateTime object into get_time_ago format by following steps:
// Import the plugin
import 'package:get_time_ago/get_time_ago.dart';
// Pass DateTime object as argument in the method
var _dateTime = DateTime.now().subtract(const Duration(minutes: 10)); // [DateTime] object
print(GetTimeAgo.parse(_dateTime)); // 10 minutes ago
// Formatting with locale
print(GetTimeAgo.parse(_dateTime, locale:'es')); // hace 10 minutos
get_time_agoIf you have saved a DateTime object as a String into a variable, database or cloud, then you have
to first convert the String into DateTime object and then pass it as argument in parse method
of get_time_ago plugin to format it into get_time_ago format by following steps:
// Import the plugin
import 'package:get_time_ago/get_time_ago.dart';
var _timestamp = '2021-05-10 05:21:37.712498'; // [DateTime] formatted as String.
var _convertedTimestamp = DateTime.parse(_timestamp); // Converting into [DateTime] object
var result = GetTimeAgo.parse(_convertedTimestamp);
print(result);
If you want to change your default locale, then call setDefaultLocale method and pass
the locale code as the argument.
// Import the plugin
import 'package:get_time_ago/get_time_ago.dart';
@override
void initState() {
super.initState();
GetTimeAgo.setDefaultLocale('fr'); // Sets the default locale to French
}
Implementing and Adding Custom Messages
class CustomMessages implements Messages {
/// Prefix added before the time message.
@override
String prefixAgo() => '';
/// Suffix added after the time message.
@override
String suffixAgo() => 'ago';
/// Message when the elapsed time is less than 15 seconds.
@override
String justNow(int seconds) => 'just now';
/// Message for when the elapsed time is less than a minute.
@override
String secsAgo(int seconds) => '$seconds seconds';
/// Message for when the elapsed time is about a minute.
@override
String minAgo(int minutes) => 'a minute';
/// Message for when the elapsed time is in minutes.
@override
String minsAgo(int minutes) => '$minutes minutes';
/// Message for when the elapsed time is about an hour.
@override
String hourAgo(int minutes) => 'an hour';
/// Message for when the elapsed time is in hours.
@override
String hoursAgo(int hours) => '$hours hours';
/// Message for when the elapsed time is about a day.
@override
String dayAgo(int hours) => 'a day';
/// Message for when the elapsed time is in days.
@override
String daysAgo(int days) => '$days days';
/// Word separator to be used when joining the parts of the message.
@override
String wordSeparator() => ' ';
}
Overriding en Locale Messages with Custom Messages
GetTimeAgo.setCustomLocaleMessages('en', CustomMessages());
If you would like to contribute to this project, feel free to fork the repository, make your changes, and submit a pull request. Please follow the guidelines in the CONTRIBUTING.md file.
This project is licensed under the MIT License - see the LICENSE file for details.
Made with contrib.rocks.
Your support helps me dedicate more time to developing high-quality, impactful projects in the open-source community. Sponsor me, and together, let’s bring even more innovation to life!
[gmail]: mailto:nkr.nikhil.nkr@gmail.com [releases]: https://github.com/nixrajput/get_time_ago/releases [repo]: https://github.com/nixrajput/get_time_ago [issues]: https://github.com/nixrajput/get_time_ago/issues [license]: https://github.com/nixrajput/get_time_ago/blob/master/LICENSE [pulls]: https://github.com/nixrajput/get_time_ago/pulls
依賴清單 1 項
>=0.19.0 <0.21.0