This will help to get how much time have passed. Useful in showing messages, notifications time and etc.
Clone or download

TimeAgo Download

I know what is mostly experianced problem when doing my development. So I decide to write this library to get how much time passed. Many of us having problem how to show how much time have passed, how to show it like in messages, notifications... Yeah, you looking at the right place. This will fix your issue.


####Let's take a look how to add this to your project

For the android project just include the following dependency inside you buil.gradle's depedency list.


repositories {

dependencies {
    compile 'com.chootdev:timezago:1.1.8'

if you using maven use following Maven


After setup installing lib to your project you just need only to calls it using just two lines of code. It will return you a string with the resuls.


TimeAgo timeAgo = new TimeAgo();
String result = timeAgo.getTimeAgo(YOUR_PAST_DATE);
TimeAgo timeAgo = new TimeAgo().locale(CONTEXT).with(CUSTOM_DATE_FORMAT);
String result = timeAgo.getTimeAgo(YOUR_CUSTOM_PAST_DATE);


  • Currently not supporting for custom date formats. supports for ISO foramt and dd/MM/yyyy HH:mm:ss only.
  • Some parts like reducing time from your input date need to manage by you, and i was planning to add those line in future too.

Output patterns

  • Below 1min - Right now
  • 1min - 1h - returns like 20 minutes
  • 1h - 24h - time eg: 12.34pm
  • 1d - 1w - 1 week ago
  • 1w - 4w - 1 week ago, 2 weeks ago 3 weeks ago
  • 1m > - date




  • 1.1.8
    • Format changes
  • 1.1.7
    • Added ru localization, changed min API from 16 to 9, custom date format
  • 1.1.6
    • Fixed grammer issues
  • 1.1.5
    • Stable the release
  • 1.1.0
    • Fixed crashing for ISO date format
  • 1.0.0
    • Initial release


Chathura Hettiarachchi,

Checkout my other contributions,


Copyright 2016 Chathura Hettiarachchi

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.