https://github.com/desktop-dart/duration
Utilities to make working with 'Duration's easier.
https://github.com/desktop-dart/duration
dartlang duration humanize legible prettify pretty-printer
Last synced: 4 months ago
JSON representation
Utilities to make working with 'Duration's easier.
- Host: GitHub
- URL: https://github.com/desktop-dart/duration
- Owner: desktop-dart
- License: bsd-3-clause
- Created: 2018-01-01T17:55:41.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2024-08-21T11:28:36.000Z (about 1 year ago)
- Last Synced: 2025-04-02T21:11:25.537Z (6 months ago)
- Topics: dartlang, duration, humanize, legible, prettify, pretty-printer
- Language: Dart
- Size: 132 KB
- Stars: 54
- Watchers: 2
- Forks: 48
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# duration [](https://pub.dartlang.org/packages/duration)
Utilities to make working with 'Duration's easier.
# Format duration
Use `Duration.pretty()` method or `prettyDuration` function to format a duration.
```dart
main() {
final dur = Duration(
days: 5,
hours: 23,
minutes: 59,
seconds: 59,
milliseconds: 999,
microseconds: 999,
);
// => 5d, 23h, 59m, 59s
print(dur.pretty());
// => 3 seconds
print((aMillisecond * 3000).pretty());
// => 2 seconds 250 milliseconds
print((aMillisecond * 2250).pretty);
// => 1 day 3 hours 2 minutes
print((aMillisecond * 97320000).pretty());
}
```
## With desired locale
Use `locale` parameter to format with desired locale.
```dart
main() {
// => 5 días 9 horas
final dur = aDay * 5 + anHour * 9;
print(
dur.pretty(
abbreviated: false,
locale: DurationLocale.fromLanguageCode('ru'),
));
}
```
## Abbreviate units
Use `abbreviated` parameter to use abbreviated units.
```dart
main() {
final dur = Duration(
days: 5,
hours: 23,
minutes: 59,
seconds: 59,
milliseconds: 999,
microseconds: 999,
);
// => 5d, 23h, 59m, 59s, 999ms, 999us
print(dur.pretty(abbreviated: true, tersity: DurationTersity.all));
}
```
## Spacer
Use `spacer` to add a string between amount and unit.
```dart
main() {
// => 5 whole days 9 whole hours
print((aDay * 5 + anHour * 9).pretty(spacer: ' whole '));
}
```
## Delimiter
Use `delimiter` to separate each individual part with a string.
```dart
main() {
// => 5 days, 9 hours and 10 minute
print((aDay * 5 + anHour * 9 + aMinute * 10).pretty(delimiter: ', '));
}
```
## Conjugation
Use `conjugation` to add a string before the final unit. Use it in conjunction with
delimiter to add ',' and 'and' to separate individual parts.
```dart
main() {
// => 5 days, 9 hours and 10 minutes
print(
(aDay * 5 + anHour * 9 + aMinute * 10).pretty(
delimiter: ', ',
conjugation: ' and ',
));
}
```
# Parse duration
## Parse duration
```dart
main() {
final Duration dur = parseDuration('245:09:08.007006');
print(dur);
}
```
## Parse time
```dart
main() {
final Duration dur = parseTime('245:09:08.007006');
print(dur);
}
```