django.utils.timesince

Constant	`TIME_STRINGS`	Undocumented
Constant	`TIMESINCE_CHUNKS`	Undocumented
Function	`timesince`	Take two datetime objects and return the time between d and now as a nicely formatted string, e.g. "10 minutes". If d occurs after now, return "0 minutes".
Function	`timeuntil`	Like timesince, but return a string measuring the time until the given time.

TIME_STRINGS =

Undocumented

Value

{'year': ngettext_lazy('%(num)d year', '%(num)d years', 'num'),
 'month': ngettext_lazy('%(num)d month', '%(num)d months', 'num'),
 'week': ngettext_lazy('%(num)d week', '%(num)d weeks', 'num'),
 'day': ngettext_lazy('%(num)d day', '%(num)d days', 'num'),
 'hour': ngettext_lazy('%(num)d hour', '%(num)d hours', 'num'),
 'minute': ngettext_lazy('%(num)d minute', '%(num)d minutes', 'num')}

TIMESINCE_CHUNKS =

Undocumented

Value

((((60*60)*24)*365, 'year'),
 (((60*60)*24)*30, 'month'),
 (((60*60)*24)*7, 'week'),
 ((60*60)*24, 'day'),
 (60*60, 'hour'),
 (60, 'minute'))

def timesince(d, now=None, reversed=False, time_strings=None, depth=2):

Take two datetime objects and return the time between d and now as a nicely formatted string, e.g. "10 minutes". If d occurs after now, return "0 minutes".

Units used are years, months, weeks, days, hours, and minutes. Seconds and microseconds are ignored. Up to depth adjacent units will be displayed. For example, "2 weeks, 3 days" and "1 year, 3 months" are possible outputs, but "2 weeks, 3 hours" and "1 year, 5 days" are not.

time_strings is an optional dict of strings to replace the default TIME_STRINGS dict.

depth is an optional integer to control the number of adjacent time units returned.

Adapted from https://web.archive.org/web/20060617175230/http://blog.natbat.co.uk/archive/2003/Jun/14/time_since

def timeuntil(d, now=None, time_strings=None, depth=2):

Like timesince, but return a string measuring the time until the given time.