Using getFormattedTime() to format a given time & setEpochTime() method

arduino-libraries#30
arduino-libraries#26

Author: taranais

NTPClient.cpp

@@ -150,8 +150,8 @@ int NTPClient::getSeconds() {
   return (this->getEpochTime() % 60);
 }
 
-String NTPClient::getFormattedTime() {
-  unsigned long rawTime = this->getEpochTime();
+String NTPClient::getFormattedTime(unsigned long secs) {
+  unsigned long rawTime = secs ? secs : this->getEpochTime();
   unsigned long hours = (rawTime % 86400L) / 3600;
   String hoursStr = hours < 10 ? "0" + String(hours) : String(hours);
 
@@ -199,3 +199,7 @@ void NTPClient::sendNTPPacket() {
   this->_udp->write(this->_packetBuffer, NTP_PACKET_SIZE);
   this->_udp->endPacket();
 }
+
+void NTPClient::setEpochTime(unsigned long secs) {
+  this->_currentEpoc = secs;
+}

NTPClient.h

@@ -76,9 +76,9 @@ class NTPClient {
     void setUpdateInterval(unsigned long updateInterval);
 
     /**
-     * @return time formatted like `hh:mm:ss`
-     */
-    String getFormattedTime();
+    * @return secs argument (or 0 for current time) formatted like `hh:mm:ss`
+    */
+    String getFormattedTime(unsigned long secs = 0);
 
     /**
      * @return time in seconds since Jan. 1, 1970
@@ -89,4 +89,9 @@ class NTPClient {
      * Stops the underlying UDP client
      */
     void end();
+
+    /**
+    * Replace the NTP-fetched time with seconds since Jan. 1, 1970
+    */
+    void setEpochTime(unsigned long secs);
 };