/EasyNTPClient

Library to read time from Network Time Protocol (NTP) servers.

Primary LanguageC++MIT LicenseMIT

EasyNTPClient

Arduino library to read time from Network Time Protocol (NTP) servers. Updated version with small fixes and improvements.

 

Features

  • Handles all heavy lifting involved with managing connections to and parsing time from an NTP server.
  • As easy as providing a UDP object to the constructor during initialization.
  • Works on Arduino and ESP8266.

 

Examples

  1. NodeMCU
    Using EasyNTPClient on a NodeMCU (ESP8266)

  2. ArduinoEspWifiShield
    Using EasyNTPClient on an Arduino UNO with an ESP-01 (ESP8266) WiFi module.
    By Claran Martis

 

Reference

Class EasyNTPClient

1. Initialization

  1. No frills
EasyNTPClient(UDP &udp)

Parameters:
    udp: Reference to an UDP object.
Returns:
    EasyNTPClient object.
  1. Custom server pool
EasyNTPClient(UDP& udp, const char* serverPool)

Parameters:
    udp: Reference to an UDP object.
	serverPool: NTP server pool. Default = "pool.ntp.org"
Returns:
    EasyNTPClient object.
  1. Time offset
EasyNTPClient(UDP& udp, const char* serverPool, int offset);

Parameters:
    udp: Reference to an UDP object.
	serverPool: NTP server pool domain name. Default = "pool.ntp.org"
	offset: Difference from UTC in seconds. Default = 0
Returns:
    EasyNTPClient object.

2. Methods

  1. Get time offset
int getTimeOffset()

Returns:
    EasyNTPClient object.
  1. Set time offset
void setTimeOffset(int offset);

Parameters:
    offset: Difference from UTC in seconds.
  1. Get time in UNIX format
unsigned long getUnixTime();

Returns:
    UTC time in UNIX time format (seconds)