← Back to branch summary

~azzar1/unity/add-show-desktop-key

« back to all changes in this revision

Viewing changes to ivle/date.py

  • Committer: William Grant
  • Date: 2009-03-26 09:20:56 UTC
  • Revision ID: grantw@unimelb.edu.au-20090326092056-q5mn972krncyo0ep
Let functions in ivle.date take datetimes, and deal in datetimes internally.

Show diffs side-by-side

added added

removed removed

Lines of Context:
ivle/date.py
15
15
# along with this program; if not, write to the Free Software
16
16
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
17
17
 
18
 
# Module: Date utilities
19
 
# Author: William Grant
20
 
# Date: 16/07/2008
 
18
'''Utilities for making nice, human readable dates.'''
21
19
 
22
20
import time
23
 
 
24
 
seconds_per_day = 86400 # 60 * 60 * 24
25
 
if time.daylight:
26
 
    timezone_offset = time.altzone
27
 
else:
28
 
    timezone_offset = time.timezone
29
 
 
30
 
def make_date_nice(seconds_since_epoch):
31
 
    """Given a number of seconds elapsed since the epoch,
 
21
import datetime
 
22
 
 
23
def get_datetime(datetime_or_seconds):
 
24
    '''Return the given datetime, or convert the given seconds since epoch.'''
 
25
    if type(datetime_or_seconds) is datetime.datetime:
 
26
        return datetime_or_seconds
 
27
    return datetime.datetime.fromtimestamp(datetime_or_seconds)
 
28
 
 
29
def make_date_nice(datetime_or_seconds):
 
30
    """Generate a full human-readable representation of a date and time.
 
31
 
 
32
    Given a datetime or number of seconds elapsed since the epoch,
32
33
    generates a string representing the date/time in human-readable form.
33
34
    "ddd mmm dd, yyyy h:m a"
34
35
    """
35
 
    #return time.ctime(seconds_since_epoch)
36
 
    return time.strftime("%a %b %d %Y, %I:%M %p",
37
 
        time.localtime(seconds_since_epoch))
38
 
 
39
 
def make_date_nice_short(seconds_since_epoch):
40
 
    """Given a number of seconds elapsed since the epoch,
 
36
    dt = get_datetime(datetime_or_seconds)
 
37
    return dt.strftime("%a %b %d %Y, %I:%M %p")
 
38
 
 
39
def make_date_nice_short(datetime_or_seconds):
 
40
    """Generate a very compact human-readable representation of a date.
 
41
 
 
42
    Given a datetime or number of seconds elapsed since the epoch,
41
43
    generates a string representing the date in human-readable form.
42
44
    Does not include the time.
43
 
    This function generates a very compact representation."""
 
45
    """
 
46
 
 
47
    dt = get_datetime(datetime_or_seconds)
 
48
    now = datetime.datetime.now()
 
49
 
44
50
    # Use a "naturalisation" algorithm.
45
 
    days_ago = (int(time.time() - timezone_offset) / seconds_per_day
46
 
        - int(seconds_since_epoch - timezone_offset) / seconds_per_day)
47
 
    if days_ago <= 5:
 
51
    delta = now - dt
 
52
 
 
53
    if delta.days <= 5:
48
54
        # Dates today or yesterday, return "today" or "yesterday".
49
 
        if days_ago == 0:
 
55
        if delta.days == 0:
50
56
            return "Today"
51
 
        elif days_ago == 1:
 
57
        elif delta.days == 1:
52
58
            return "Yesterday"
53
59
        else:
54
 
            return str(days_ago) + " days ago"
55
 
        # Dates in the last 5 days, return "n days ago".
 
60
            # Dates in the last 5 days, return "n days ago".
 
61
            return str(delta.days) + " days ago"
56
62
    # Other dates, return a short date format.
57
63
    # If within the same year, omit the year (mmm dd)
58
 
    if time.localtime(seconds_since_epoch).tm_year==time.localtime().tm_year:
59
 
        return time.strftime("%b %d", time.localtime(seconds_since_epoch))
 
64
    if dt.year == now.year:
 
65
        return dt.strftime("%b %d")
60
66
    # Else, include the year (mmm dd, yyyy)
61
67
    else:
62
 
        return time.strftime("%b %d, %Y", time.localtime(seconds_since_epoch))
 
68
        return dt.strftime("%b %d, %Y")