← Back to branch summary

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

« back to all changes in this revision

Viewing changes to ivle/date.py

  • Committer: Matt Giuca
  • Date: 2010-07-22 02:12:36 UTC
  • mfrom: (1812.1.13 late-submit)
  • Revision ID: matt.giuca@gmail.com-20100722021236-k8kt4cqdtywzpk24
https://launchpad.net/bugs/598346
Merge from trunk late-submit.
Students may now submit projects after the deadline, but they are warned that the submission is late.
Lecturers are now given data on which submissions were made late, and how many days.
(LP: #598346)

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
 
 
26
    >>> get_datetime(1000000000)
 
27
    datetime.datetime(2001, 9, 9, 11, 46, 40)
 
28
    >>> get_datetime(2000000000)
 
29
    datetime.datetime(2033, 5, 18, 13, 33, 20)
 
30
 
 
31
    >>> get_datetime(datetime.datetime(2009, 5, 26, 11, 38, 53))
 
32
    datetime.datetime(2009, 5, 26, 11, 38, 53)
 
33
    >>> get_datetime(datetime.datetime(2001, 9, 9, 11, 46, 40))
 
34
    datetime.datetime(2001, 9, 9, 11, 46, 40)
 
35
    '''
 
36
    if type(datetime_or_seconds) is datetime.datetime:
 
37
        return datetime_or_seconds
 
38
    return datetime.datetime.fromtimestamp(datetime_or_seconds)
 
39
 
 
40
def make_date_nice(datetime_or_seconds):
 
41
    """Generate a full human-readable representation of a date and time.
 
42
 
 
43
    Given a datetime or number of seconds elapsed since the epoch,
32
44
    generates a string representing the date/time in human-readable form.
33
45
    "ddd mmm dd, yyyy h:m a"
 
46
 
 
47
    >>> make_date_nice(datetime.datetime(2009, 5, 26, 11, 38, 53))
 
48
    'Tue May 26 2009, 11:38am'
34
49
    """
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,
 
50
    dt = get_datetime(datetime_or_seconds)
 
51
    return dt.strftime("%a %b %d %Y, %l:%M%P")
 
52
 
 
53
def make_date_nice_short(datetime_or_seconds):
 
54
    """Generate a very compact human-readable representation of a date.
 
55
 
 
56
    Given a datetime or number of seconds elapsed since the epoch,
41
57
    generates a string representing the date in human-readable form.
42
58
    Does not include the time.
43
 
    This function generates a very compact representation."""
 
59
 
 
60
    >>> now = datetime.datetime.now()
 
61
    >>> make_date_nice_short(now)
 
62
    'Today'
 
63
    >>> make_date_nice_short(now - datetime.timedelta(1))
 
64
    'Yesterday'
 
65
    >>> make_date_nice_short(now - datetime.timedelta(2))
 
66
    '2 days ago'
 
67
    >>> make_date_nice_short(now - datetime.timedelta(5))
 
68
    '5 days ago'
 
69
    >>> make_date_nice_short(1242783748)
 
70
    'May 20, 2009'
 
71
    """
 
72
 
 
73
    dt = get_datetime(datetime_or_seconds)
 
74
    now = datetime.datetime.now()
 
75
 
44
76
    # 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:
 
77
    delta = now - dt
 
78
 
 
79
    if delta.days <= 5:
48
80
        # Dates today or yesterday, return "today" or "yesterday".
49
 
        if days_ago == 0:
 
81
        if delta.days == 0:
50
82
            return "Today"
51
 
        elif days_ago == 1:
 
83
        elif delta.days == 1:
52
84
            return "Yesterday"
53
85
        else:
54
 
            return str(days_ago) + " days ago"
55
 
        # Dates in the last 5 days, return "n days ago".
 
86
            # Dates in the last 5 days, return "n days ago".
 
87
            return str(delta.days) + " days ago"
56
88
    # Other dates, return a short date format.
57
89
    # 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))
 
90
    if dt.year == now.year:
 
91
        return dt.strftime("%b %d")
60
92
    # Else, include the year (mmm dd, yyyy)
61
93
    else:
62
 
        return time.strftime("%b %d, %Y", time.localtime(seconds_since_epoch))
 
94
        return dt.strftime("%b %d, %Y")
 
95
 
 
96
def format_datetime_for_paragraph(datetime_or_seconds):
 
97
    """Generate a compact representation of a datetime for use in a paragraph.
 
98
 
 
99
    Given a datetime or number of seconds elapsed since the epoch, generates
 
100
    a compact string representing the date and time in human-readable form.
 
101
 
 
102
    Unlike make_date_nice_short, the time will always be included.
 
103
 
 
104
    Also unlike make_date_nice_short, it is suitable for use in the middle of
 
105
    a block of prose and properly handles timestamps in the future nicely.
 
106
 
 
107
    >>> now = datetime.datetime.now()
 
108
    >>> today = now.date()
 
109
    >>> time = datetime.time(10, 35, 40)
 
110
    >>> earlier = datetime.datetime.combine(today, time)
 
111
    >>> date = datetime.datetime(2009, 5, 20, 21, 19, 53)
 
112
 
 
113
    >>> format_datetime_for_paragraph(now)
 
114
    'now'
 
115
 
 
116
    # We can go backwards and forwards a little while and be pretty.
 
117
    >>> format_datetime_for_paragraph(now - datetime.timedelta(0, 40))
 
118
    '40 seconds ago'
 
119
    >>> format_datetime_for_paragraph(now + datetime.timedelta(0, 30))
 
120
    'in 29 seconds'
 
121
 
 
122
    >>> format_datetime_for_paragraph(now - datetime.timedelta(0, 245))
 
123
    '4 minutes ago'
 
124
    >>> format_datetime_for_paragraph(now + datetime.timedelta(0, 3500))
 
125
    'in 58 minutes'
 
126
 
 
127
    # If we go back further, it gets a bit ugly.
 
128
    >>> format_datetime_for_paragraph(earlier - datetime.timedelta(1))
 
129
    'yesterday at 10:35am'
 
130
    >>> format_datetime_for_paragraph(date)
 
131
    'on 2009-05-20 at  9:19pm'
 
132
 
 
133
    >>> format_datetime_for_paragraph(earlier + datetime.timedelta(1))
 
134
    'tomorrow at 10:35am'
 
135
    """
 
136
 
 
137
    dt = get_datetime(datetime_or_seconds)
 
138
    now = datetime.datetime.now()
 
139
 
 
140
    delta = dt - now
 
141
 
 
142
    # If the date is earlier than now, we want to either say something like
 
143
    # '5 days ago' or '25 seconds ago', 'yesterday at 08:54' or
 
144
    # 'on 2009-03-26 at 20:09'.
 
145
 
 
146
    # If the time is within one hour of now, we show it nicely in either
 
147
    # minutes or seconds.
 
148
 
 
149
    if abs(delta).days == 0 and abs(delta).seconds <= 1:
 
150
        return 'now'
 
151
 
 
152
    if abs(delta).days == 0 and abs(delta).seconds < 60*60:
 
153
        if abs(delta) == delta:
 
154
            # It's in the future.
 
155
            prefix = 'in '
 
156
            suffix = ''
 
157
        else:
 
158
            prefix = ''
 
159
            suffix = ' ago'
 
160
 
 
161
        # Show the number of minutes unless we are within two minutes.
 
162
        if abs(delta).seconds >= 120:
 
163
            return (prefix + '%d minutes' + suffix) % (abs(delta).seconds / 60)
 
164
        else:
 
165
            return (prefix + '%d seconds' + suffix) % (abs(delta).seconds)
 
166
 
 
167
    if dt < now:
 
168
        if dt.date() == now.date():
 
169
            # Today.
 
170
            return dt.strftime('today at %l:%M%P')
 
171
        elif dt.date() == now.date() - datetime.timedelta(days=1):
 
172
            # Yesterday.
 
173
            return dt.strftime('yesterday at %l:%M%P')
 
174
    elif dt > now:
 
175
        if dt.date() == now.date():
 
176
            # Today.
 
177
            return dt.strftime('today at %l:%M%P')
 
178
        elif dt.date() == now.date() + datetime.timedelta(days=1):
 
179
            # Tomorrow
 
180
            return dt.strftime('tomorrow at %l:%M%P')
 
181
 
 
182
    return dt.strftime('on %Y-%m-%d at %l:%M%P')