About Days on Earth

Hello.

Select your date of birth - or any other date - and DoE will show you how many days you have been on this earth.

It will also show you on what date you will reach a few significant numbers of days.

If you select a date in the future, it will show the number of days we will have to wait for that day.

Once you have selected a date you can copy the URL to share your date with anybody you like.

API

There is a simple HTTP API for you to fetch information for use somewhere else. You can use this to show your Days on Earth on a dashboard or your mobile device.

All requests described below go to http://days-on-earth.com/api/…

Days

http://days-on-earth.com/api/YYYY/MM/DD

Returns just your number of Days on Earth. By default it will return this simple JSON format:

URL:
http://days-on-earth.com/api/1981/11/22
Result:
{"days":12774}

If you want to get just the number without any additional text around it, add ?format=plain, like this:

URL:
http://days-on-earth.com/api/1981/11/22?format=plain
Result:
12774

There is an additional special formatting option for using DoE numbers with the iOS app Numerics:

URL:
http://days-on-earth.com/api/1981/11/22?format=numerics
Result:
{"data":{"value":12774},"postfix":"days"}

When adding a widget to your dashboard, choose "Custom JSON" -> "Number from JSON data" as the type, then just put the proper URL into the field "JSON URL". Everything else is optional.

You can even modify the postfix string:

URL:
http://days-on-earth.com/api/1981/11/22?format=numerics&postfix=since%20my%20birth
Result:
{"data":{"value":12774},"postfix":"since my birth"}

When

http://days-on-earth.com/api/YYYY/MM/DD/when/DAYS

Returns the date on which you reach the number of DAYS.

URL:
http://days-on-earth.com/api/1981/11/22/when/20000
Result:
{"date":"2036-08-24"}

The same format and postfix settings apply as documented above.

Interesting

http://days-on-earth.com/api/YYYY/MM/DD/interesting

This is used for showing the results on this website.

URL:
http://days-on-earth.com/api/1981/11/22/interesting
Result (formatted for better readability here):
{
    "days": 246,
    "interesting": [
        {
            "date": "2016-03-11",
            "days": "1",
            "label": "First Day on Earth"
        },
        {
            "date": "2016-11-11",
            "days": "246",
            "label": "Today"
        },
        {
            "date": "2018-12-05",
            "days": "1000",
            "label": ""
        },
        …and so on…
    ]
}

Go back to the beginning

Inspired by the film 20,000 days on earth.

Created by _Lasar - more at lasar.org.