add Time example

Author: maciejbocianski

APIs_Platform/time_HelloWorld/README.md

@@ -0,0 +1,6 @@
+# Time example
+
+The time interface is used to access the Real Time Clock (RTC). The time is set as an offset measured in seconds from the time epoch, which is library specific. In general the accepted time epoch is the Unix Epoch. An online converter between human readable time and Unix Epoch time is handy, try this one. If the system is not battery powered then on each reset the rtc time will be reset. Make sure to either provide battery power to keep the time or to reset it each time the device is run. 
+
+There is no official time API, instead you use the functions in the example code.
+

APIs_Platform/time_HelloWorld/main.cpp

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2006-2020 Arm Limited and affiliates.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+#include "mbed.h"
+
+
+int main()
+{
+    set_time(1256729737);  // Set RTC time to Wed, 28 Oct 2009 11:35:37
+
+    while (true) {
+        time_t seconds = time(NULL);
+
+        printf("Time as seconds since January 1, 1970 = %u\n", (unsigned int)seconds);
+
+        printf("Time as a basic string = %s", ctime(&seconds));
+
+        char buffer[32];
+        strftime(buffer, 32, "%I:%M %p\n", localtime(&seconds));
+        printf("Time as a custom formatted string = %s", buffer);
+
+        ThisThread::sleep_for(1000);
+    }
+}