Add device_time property

Author: imurchie

appium/webdriver/mobilecommand.py

@@ -56,3 +56,4 @@ class MobileCommand(object):
     GET_SETTINGS = 'getSettings'
     UPDATE_SETTINGS = 'updateSettings'
     SET_LOCATION = 'setLocation'
+    GET_DEVICE_TIME = 'getDeviceTime'

appium/webdriver/webdriver.py

@@ -728,6 +728,12 @@ def set_location(self, latitude, longitude, altitude):
         self.execute(Command.SET_LOCATION, data)
         return self
 
+    @property
+    def device_time(self):
+        """Returns the date and time fomr the device
+        """
+        return self.execute(Command.GET_DEVICE_TIME, {})['value']
+
     def _addCommands(self):
         self.command_executor._commands[Command.CONTEXTS] = \
             ('GET', '/session/$sessionId/contexts')
@@ -810,3 +816,5 @@ def _addCommands(self):
             ('POST', '/session/$sessionId/location')
         self.command_executor._commands[Command.LOCATION_IN_VIEW] = \
             ('GET', '/session/$sessionId/element/$id/location_in_view')
+        self.command_executor._commands[Command.GET_DEVICE_TIME] = \
+            ('GET', '/session/$sessionId/appium/device/system_time')

test/functional/android/appium_tests.py

@@ -19,6 +19,7 @@
 import os
 import random
 from time import sleep
+from dateutil.parser import parse
 
 from selenium.common.exceptions import NoSuchElementException
 
@@ -230,6 +231,11 @@ def test_element_location_in_view(self):
         self.assertIsNotNone(loc['x'])
         self.assertIsNotNone(loc['y'])
 
+    def test_device_time(self):
+        date_time = self.driver.device_time
+        # convert to date ought to work
+        parse(date_time)
+
 
 if __name__ == "__main__":
     suite = unittest.TestLoader().loadTestsFromTestCase(AppiumTests)