Web   ·   Wiki   ·   Activities   ·   Blog   ·   Lists   ·   Chat   ·   Meeting   ·   Bugs   ·   Git   ·   Translate   ·   Archive   ·   People   ·   Donate
summaryrefslogtreecommitdiffstats
path: root/sugar/date.py
diff options
context:
space:
mode:
Diffstat (limited to 'sugar/date.py')
-rw-r--r--sugar/date.py15
1 files changed, 15 insertions, 0 deletions
diff --git a/sugar/date.py b/sugar/date.py
index 331124b..2894a87 100644
--- a/sugar/date.py
+++ b/sugar/date.py
@@ -1,10 +1,25 @@
+"""Simple date-representation model"""
import datetime
class Date(object):
+ """Date-object storing a simple time.time() float
+
+ XXX not sure about the rationale for this class,
+ possibly it makes transfer over dbus easier?
+ """
def __init__(self, timestamp):
+ """Initialise via a timestamp (floating point value)"""
self._timestamp = timestamp
def __str__(self):
+ """Produce a formatted date representation
+
+ Eventually this should produce a localised version
+ of the date. At the moment it always produces English
+ dates in long form with Today and Yesterday
+ special-cased and dates from this year not presenting
+ the year in the date.
+ """
date = datetime.date.fromtimestamp(self._timestamp)
today = datetime.date.today()