TIMEZONES

edx_user_state_client/interface.py

@@ -34,7 +34,7 @@ class XBlockUserState(namedtuple('_XBlockUserState', ['username', 'block_key', '
         state: A dict mapping field names to the values of those fields for this XBlock.
         updated: A :class:`datetime.datetime`. We guarantee that the fields
                  that were returned in "state" have not been changed since
-                 this time.
+                 this time (in UTC).
         scope: A :class:`xblock.fields.Scope` identifying which XBlock scope this state is coming from.
     """
     __slots__ = ()

edx_user_state_client/tests.py

@@ -17,6 +17,7 @@ test suite, use the snippet:
 
 from datetime import datetime
 from unittest import TestCase
+import pytz
 
 from contracts import contract
 from edx_user_state_client.interface import XBlockUserStateClient, XBlockUserState
@@ -353,9 +354,9 @@ class _UserStateClientTestCRUD(_UserStateClientTestUtils):
         self.assertItemsEqual(self.get_many(user=0, blocks=[0, 1]), [])
 
     def test_get_mod_date(self):
-        start_time = datetime.utcnow()
+        start_time = datetime.now(pytz.utc)
         self.set_many(user=0, block_to_state={0: {'a': 'b'}, 1: {'b': 'c'}})
-        end_time = datetime.utcnow()
+        end_time = datetime.now(pytz.utc)
 
         mod_dates = self.get(user=0, block=0)
 
@@ -364,15 +365,15 @@ class _UserStateClientTestCRUD(_UserStateClientTestUtils):
         self.assertLess(mod_dates.updated, end_time)
 
     def test_get_many_mod_date(self):
-        start_time = datetime.utcnow()
+        start_time = datetime.now(pytz.utc)
         self.set_many(
             user=0,
             block_to_state={0: {'a': 'b'}})
-        mid_time = datetime.utcnow()
+        mid_time = datetime.now(pytz.utc)
         self.set_many(
             user=0,
             block_to_state={1: {'a': 'c'}})
-        end_time = datetime.utcnow()
+        end_time = datetime.now(pytz.utc)
 
         mod_dates = list(self.get_many(
             user=0,
@@ -621,7 +622,7 @@ class DictUserStateClient(XBlockUserStateClient):
         Add the specified state to the state history of this block.
         """
         history_list = self._history.setdefault((username, block_key, scope), [])
-        history_list.insert(0, XBlockUserState(username, block_key, state, datetime.utcnow(), scope))
+        history_list.insert(0, XBlockUserState(username, block_key, state, datetime.now(pytz.utc), scope))
 
     def get_many(self, username, block_keys, scope=Scope.user_state, fields=None):
         for key in block_keys: