Running on your ESP8266, this NTP Time Zone Arduino

IDE Sketch will display the exact time on MAX 7219 Display.

The sketch uses the Timezone library of JChristensen which converts the time to daylight summer time and standard time for any region.

Clock Features:-

  • Exact Time
  • Synchronization of Time With NTP Servers
  • Indication, If Time Will Not be Synchronized , Hash before “A”(Am) and “P”(PM)
  • Daylight Summer Time and Standard Time for Any Region.
  • Saving Access Point Credentials in The Clock Through Web Browser
  • Credentials Can Be Erased With a Push Button Switch

The provided libraries will comply only with Arduino IDE 1.6.5 and you must use the provided libraries.

Do not update the libraries after unzipping the provided libraries. It is better you rename your present “libraries” folder and copy all the library files in the new “libraries” folder.

Don’t forget to edit the “Timezone lines” in the sketch for your region. Documentation is available at JChristensen's GitHub page.

Required Hardware.

  1. Power Supply 3.3V and 5V
  2. ESP8266
  3. MAX 7219 LED Display
  4. Push Button Switch

The Zip folder contains, Libraries, Drawing and The Sketch.



    • Oil Contest

      Oil Contest
    • Creative Misuse Contest

      Creative Misuse Contest
    • Clocks Contest

      Clocks Contest

    9 Discussions

    Hallo super Job thanks for your work.

    i'm doing something wrong, my display is not working correctly :-/

    Software / Hardware:

    Arduino IDE 1.8.5

    Max7219 (LED Version not 7-seg)

    ESP8266 E12 Nodemcu

    Which Pins (Clk, Din & CS/Load) should i use?

    4 replies


    Can you please let me know exact type of display connected. Is it dot matrix 4 in one like the image?


    The sketch/code is for 7 segment LED display and will not work for other type displays. I must modify the sketch to work for 4 in 1 display dot matrix module. I will send it to you once it's ready

    Hallo Great Work!

    I live in Germany and i put this
    static const char ntpServerName[] = "";
    instead of
    static const char ntpServerName[] = "";

    So! Only two problems to solve and the clock is perfect for me :-)
    1. How can i change from 04.24.00 P to 16-24-00

    2. If the board is switched on and the stored Wlan is not on, then comes setup. Is it possible to do this so that the time displayed by the DS3231 and pressing the reset button tries to connect.
    Or even without reset button, anyway! Headache the clock is running.

    The background is the one where the clock is just Wlan from my iPhone and I'm not there every day. After this possibility many have asked, so would be a milestone for this watch.

    For help, I would be grateful.
    Also in a forum of your choice.

    And sorry for my bad english

    Thanks for this project. I was looking for such cheap clock. I did some modifications by adding a second unit which displays day, month and year. In addition, the libraries included in the ZIP are not neccesary as they are standard. You need to change the line

    #include <Time.h> to

    #include <TimeLib.h>


    unsigned int HexToBCD(unsigned int number)


    unsigned char i = 0;

    unsigned int k = 0;

    while (number)


    k = (k) | ((number % 10) << i * 4);

    number = number / 10;



    return (k);


    void digitalClockDisplay() {

    tmElements_t tm;

    char *dayOfWeek;

    breakTime(now(), tm);


    // Start with left digit

    lc.setDigit(0, 7, int(hour(CE.toLocal(utc, &tcr)) / 10), false);

    lc.setDigit(0, 6, (hour(CE.toLocal(utc, &tcr)) % 10), false);

    lc.setChar(0, 5, '-', false);

    lc.setDigit(0, 4, (minute() / 10), false);

    lc.setDigit(0, 3, (minute() % 10), false);

    lc.setChar(0, 2, '-', false);

    lc.setDigit(0, 1, int(second() / 10), false);

    lc.setDigit(0, 0, (second() % 10), false);

    lc.setDigit(1, 7, int(day(CE.toLocal(utc, &tcr)) / 10), false);

    lc.setDigit(1, 6, (day(CE.toLocal(utc, &tcr)) % 10), true);

    lc.setDigit(1, 5, int(month(CE.toLocal(utc, &tcr)) / 10), false);

    lc.setDigit(1, 4, (month(CE.toLocal(utc, &tcr)) % 10), true);

    unsigned int count_one;

    count_one = HexToBCD(year(CE.toLocal(utc, &tcr)));

    lc.setDigit(1, 3, ((count_one >> 12) & 0x0F), false);

    lc.setDigit(1, 2, ((count_one >> 8) & 0x0F), false);

    lc.setDigit(1, 1, ((count_one >> 4) & 0x0F), false);

    lc.setDigit(1, 0, (count_one & 0x0F), false);


    1 reply

    AdrianCronauer Thanks for your comments. I agree that most of the libraries are standard but I have edited the timezone library by removing all lines related with EEPROM in order to compile

    Neat idea :)