Lightweight formatter converting durations into human-readable "time ago" strings. Zero dependencies, single-file implementation, customizable locale translations, supports past and future phrasing, minimal extensible API.
A lightweight Kotlin Multiplatform library for formatting durations into human-readable "time ago" strings.
Add the dependency to your build.gradle.kts:
// For common/shared module
commonMain.dependencies {
implementation("io.github.samuolis:timeago-kmp:0.1.11")
}
In Xcode: File → Add Package Dependencies → Enter:
https://github.com/samuolis/timeago-kmp
Or add to your Package.swift:
dependencies: [
.package(url: "https://github.com/samuolis/timeago-kmp", from: "0.1.11")
]
npm install timeago-kmp
Or with yarn:
yarn add timeago-kmp
import io.github.samuolis.timeago.timeAgo
import kotlin.time.Duration.Companion.minutes
import kotlin.time.Duration.Companion.hours
import kotlin.time.Duration.Companion.days
5.minutes.timeAgo() // "5 minutes ago"
1.hours.timeAgo() // "1 hour ago"
2.days.timeAgo() // "2 days ago"
45.seconds.timeAgo()
(-).days.timeAgo()
(-).hours.timeAgo()
import TimeAgoKMP
// Using TimeAgo object
TimeAgo.shared.fromSeconds(seconds: 30)
.shared.fromMinutes(minutes: )
.shared.fromHours(hours: )
.shared.fromDays(days: )
.shared.fromDays(days: )
.timeAgoFromSeconds(seconds: )
{ } ;
.();
.();
.();
.();
.(-);
// CommonJS
const { TimeAgo } = require('timeago-kmp');
TimeAgo.fromSeconds(300); // "5 minutes ago"
import Foundation
import TimeAgoKMP
extension Date {
func timeAgo() -> String {
let seconds (().timeIntervalSince())
.shared.fromSeconds(seconds: seconds)
}
}
postDate ().addingTimeInterval()
(postDate.timeAgo())
Kotlin:
MIT License - see LICENSE for details.
kotlin.time.Duration from Kotlin stdlibTimeAgoLocaleobject GermanLocale : TimeAgoLocale {
override val justNow = "gerade eben"
override val oneMinuteAgo = "vor 1 Minute"
override fun minutesAgo(minutes: Long) = "vor $minutes Minuten"
override val oneHourAgo = "vor 1 Stunde"
override fun hoursAgo(hours: Long) = "vor $hours Stunden"
override val yesterday = "gestern"
override fun daysAgo(days: Long) = "vor $days Tagen"
// ... implement remaining properties
}
2.hours.timeAgo(GermanLocale) // "vor 2 Stunden"
| Duration | Output |
|---|
| 30 seconds | just now |
| 1 minute | 1 minute ago |
| 5 minutes | 5 minutes ago |
| 1 hour | 1 hour ago |
| 3 hours | 3 hours ago |
| 1 day | yesterday |
| 5 days | 5 days ago |
| 1 week | 1 week ago |
| 2 weeks | 2 weeks ago |
| 1 month | 1 month ago |
| 6 months | 6 months ago |
| 1 year | 1 year ago |
| 3 years | 3 years ago |
Surfaced from shared tags and platforms — no rankings paid for.