Merge pull request #104 from PyconUK/issue-89

Remove all use of strings for Slot.starts_at

Author: drvinceknight

docs/howto/obtain_mathematical_representation.rst

@@ -5,11 +5,12 @@ When scheduling a conference, it might be desirable to recover the schedule in a
 different format.
 Let us schedule a simple conference as described in :ref:`tutorial`::
 
+    >>> from datetime import datetime
     >>> from conference_scheduler.resources import Slot, Event
     >>> from conference_scheduler import scheduler, converter
 
-    >>> slots  = [Slot(venue='Big', starts_at='15-Sep-2016 09:30', duration=30, session="A", capacity=200),
-    ...           Slot(venue='Big', starts_at='15-Sep-2016 10:00', duration=30, session="A", capacity=200)]
+    >>> slots  = [Slot(venue='Big', starts_at=datetime(2016, 9, 15, 9, 30), duration=30, session="A", capacity=200),
+    ...           Slot(venue='Big', starts_at=datetime(2016, 9, 15, 10, 0), duration=30, session="A", capacity=200)]
     >>> events = [Event(name='Talk 1', duration=30, demand=50),
     ...           Event(name='Talk 2', duration=30, demand=130)]
 
@@ -19,8 +20,8 @@ We can view this schedule as before::
 
     >>> for item in schedule:
     ...     print(f"{item.event.name} at {item.slot.starts_at} in {item.slot.venue}")
-    Talk 1 at 15-Sep-2016 09:30 in Big
-    Talk 2 at 15-Sep-2016 10:00 in Big
+    Talk 1 at 2016-09-15 09:30:00 in Big
+    Talk 2 at 2016-09-15 10:00:00 in Big
 
 If we want to recover the mathematical array form of our solution (as described
 in :ref:`mathematical-model`), we use the :code:`scheduler.schedule_to_array`
@@ -36,5 +37,5 @@ We can also return from a mathematical array to the schedule using the
 
     >>> for item in converter.array_to_schedule(array, events=events, slots=slots):
     ...     print(f"{item.event.name} at {item.slot.starts_at} in {item.slot.venue}")
-    Talk 1 at 15-Sep-2016 09:30 in Big
-    Talk 2 at 15-Sep-2016 10:00 in Big
+    Talk 1 at 2016-09-15 09:30:00 in Big
+    Talk 2 at 2016-09-15 10:00:00 in Big