【NodeMCU实时天气时钟温湿度项目 4】通过NTPClient库获取实时网络时间并显示在TFT屏幕上

        今天是【实时天气时钟温湿度项目】第四专题，主要内容是：学习导入NTPClient库，通过这个库获取实时网络时间，显示在1.3寸TFT液晶屏幕上。此前三个专题，请选择查看以下链接。

        第一专题内容，请参考
        【NodeMCU实时天气时钟温湿度项目 1】连接点亮SPI-TFT屏幕和UI布局设计-CSDN博客
        第二专题内容，请参考
        【NodeMCU实时天气时钟温湿度项目 2】WIFI模式设置及连接-CSDN博客
        第三专题内容，请参考       
【NodeMCU实时天气时钟温湿度项目 3】连接SHT30传感器，获取并显示当前环境温湿度数据（I2C）-CSDN博客
        NTPClient功能库有关内容，请参考
        【Arduino】NTPClient：连接NTP服务器获取实时网络时间_ntpclient.h-CSDN博客

一、添加NTPClient库

        获取实时网络时间，一般通过 NTP (网络时间协议)服务器来实现。在Arduino框架下，我们通过NTPClient库提供的函数功能，连接到NTP服务器，从服务器获取时间，并保持同步。
        添加库的方法：打开 PlatformIO 界面，选择 Libraries 图标，在搜索栏内输入 NTPClient，在查询结果中选择NTPClient库，,添加到本项目中。

二、NTPClient官方示例代码及主要函数

        下面是NTPClient库官方示例 Advanced.info 的代码内容，将其全文复制到主文件 main.cpp 中，添加库，编译上传到NodeMCU开发板，就可以正常运行了。
        提醒：请务必将 ssid 和 password ，变更为您所在环境的 AP访问点名称和密码。       

#include <NTPClient.h>
// change next line to use with another board/shield
#include <ESP8266WiFi.h>
//#include <WiFi.h> // for WiFi shield
//#include <WiFi101.h> // for WiFi 101 shield or MKR1000
#include <WiFiUdp.h>

const char *ssid     = "xcb940";
const char *password = "87589940abc";

WiFiUDP ntpUDP;

// You can specify the time server pool and the offset (in seconds, can be
// changed later with setTimeOffset() ). Additionally you can specify the
// update interval (in milliseconds, can be changed using setUpdateInterval() ).
NTPClient timeClient(ntpUDP, "europe.pool.ntp.org", 3600, 60000);

void setup(){
  Serial.begin(115200);

  WiFi.begin(ssid, password);

  while ( WiFi.status() != WL_CONNECTED ) {
    delay ( 500 );
    Serial.print ( "." );
  }

  timeClient.begin();
}

void loop() {
  timeClient.update();

  Serial.println(timeClient.getFormattedTime());

  delay(1000);
}

下图是程序正常运行后的模样。

        特别说明：关于NTPClient库的介绍和应用，我在前期曾发布过一个博文，对这个库作了详细介绍。官方示例中涉及到的功能函数，在博文中都有详细介绍，具体内容请点击下面的链接查看：【Arduino】NTPClient：连接NTP服务器获取实时网络时间_ntpclient.h-CSDN博客

三、本项目关于获取网络时间函数说明       

        通过NTPClient功能库获取网络时间的代码，封装在项目的 ntptime.h 文件中，主要有以下4个功能函数。
        （1）void initNtp()，启动NTPClient，开始客户端与NTP服务器同步、获取UTC时间，填充时日期时间数据结构 struct dt_data；设置时区偏移量（28800 = 60 * 60 * 8 秒）。

void initNtp() {
  timeClient.begin();
  //28800 = +8时区（我们的北京时间）
  timeClient.setTimeOffset(28800);
  loopNtp();
}

struct dt_data {
  String localDate = "";
  String localTime = "";
  String y;
  String m;
  String d;
  String h;
  String i;
  String s;
  uint16_t year;
  uint8_t month;
  uint8_t day;
  uint8_t hours;
  uint8_t minutes;
  uint8_t seconds;
} dt;

        （2）void loopNtp()，获取UTC时间，进行格式转换，填充时日期时间数据结构 struct dt_data；每调用一次，获取一次时间。

void loopNtp() {
  timeClient.update();
  Serial.println(timeClient.getFormattedTime());
  //获取unix时间戳（1970年至今的总秒数）
  unsigned long epochTime = timeClient.getEpochTime();
  Serial.print("epochTime: ");
  Serial.println(epochTime);

  //格式化得到 时:分:秒
  dt.localTime = timeClient.getFormattedTime();

  //重新计算得到 年-月-日
  time_t rawtime = epochTime;
  struct tm * ti;
  ti = localtime (&rawtime);

  dt.year = ti->tm_year + 1900;
  dt.y = String(dt.year);

  dt.month = ti->tm_mon + 1;
  dt.m = dt.month < 10 ? "0" + String(dt.month) : String(dt.month);

  dt.day = ti->tm_mday;
  dt.d = dt.day < 10 ? "0" + String(dt.day) : String(dt.day);

  dt.hours = ti->tm_hour;
  dt.h = dt.hours < 10 ? "0" + String(dt.hours) : String(dt.hours);

  dt.minutes = ti->tm_min;
  dt.i = dt.minutes < 10 ? "0" + String(dt.minutes) : String(dt.minutes);

  dt.seconds = ti->tm_sec;
  dt.s = dt.seconds < 10 ? "0" + String(dt.seconds) : String(dt.seconds);

  //将得到的年月日写入weather_data 结构体
  dt.localDate = dt.y + "-" + dt.m + "-" + dt.d;
  //Serial.println(dt.h + "-" + dt.i + "-" + dt.s);
}

        （3）LunarDate LunarCalendar(int year, int month, int day)，将阳历的年月日转换成阴历的年月日，存放到结构体 struct LunarDate 中。

LunarDate LunarCalendar(int year, int month, int day)
{
  int Spring_NY, Sun_NY, StaticDayCount;
  int index, flag;
  //Spring_NY 记录春节离当年元旦的天数。
  //Sun_NY 记录阳历日离当年元旦的天数。
  if ( ((LunarCalendarTable[year - 1901] & 0x0060) >> 5) == 1)
    Spring_NY = (LunarCalendarTable[year - 1901] & 0x001F) - 1;
  else
    Spring_NY = (LunarCalendarTable[year - 1901] & 0x001F) - 1 + 31;
  Sun_NY = MonthAdd[month - 1] + day - 1;
  if ( (!(year % 4)) && (month > 2))
    Sun_NY++;
  //StaticDayCount记录大小月的天数 29 或30
  //index 记录从哪个月开始来计算。
  //flag 是用来对闰月的特殊处理。
  //判断阳历日在春节前还是春节后
  if (Sun_NY >= Spring_NY)//阳历日在春节后（含春节那天）
  {
    Sun_NY -= Spring_NY;
    month = 1;
    index = 1;
    flag = 0;
    if ( ( LunarCalendarTable[year - 1901] & (0x80000 >> (index - 1)) ) == 0)
      StaticDayCount = 29;
    else
      StaticDayCount = 30;
    while (Sun_NY >= StaticDayCount)
    {
      Sun_NY -= StaticDayCount;
      index++;
      if (month == ((LunarCalendarTable[year - 1901] & 0xF00000) >> 20) )
      {
        flag = ~flag;
        if (flag == 0)
          month++;
      }
      else
        month++;
      if ( ( LunarCalendarTable[year - 1901] & (0x80000 >> (index - 1)) ) == 0)
        StaticDayCount = 29;
      else
        StaticDayCount = 30;
    }
    day = Sun_NY + 1;
  }
  else //阳历日在春节前
  {
    Spring_NY -= Sun_NY;
    year--;
    month = 12;
    if ( ((LunarCalendarTable[year - 1901] & 0xF00000) >> 20) == 0)
      index = 12;
    else
      index = 13;
    flag = 0;
    if ( ( LunarCalendarTable[year - 1901] & (0x80000 >> (index - 1)) ) == 0)
      StaticDayCount = 29;
    else
      StaticDayCount = 30;
    while (Spring_NY > StaticDayCount)
    {
      Spring_NY -= StaticDayCount;
      index--;
      if (flag == 0)
        month--;
      if (month == ((LunarCalendarTable[year - 1901] & 0xF00000) >> 20))
        flag = ~flag;
      if ( ( LunarCalendarTable[year - 1901] & (0x80000 >> (index - 1)) ) == 0)
        StaticDayCount = 29;
      else
        StaticDayCount = 30;
    }
    day = StaticDayCount - Spring_NY + 1;
  }
  LunarCalendarDay |= day;
  LunarCalendarDay |= (month << 6);

  LunarDate d;
  d.year = year;
  d.month = month;
  d.day = day;
  if (month == ((LunarCalendarTable[year - 1901] & 0xF00000) >> 20))
    d.leap =  1;
  else
    d.leap =  0;
  return d;
}

String outputLunarDate(int year, int month, int day) {
  LunarDate ld = LunarCalendar(year, month, day);
  String str = "";
  if (ld.leap) {
    str += "闰";
  } else {
    str += " ";
  }
  str += ChMonth[ld.month] + ChDay[ld.day];
  return str;
}

        （4）String weekOfDate1(int year, int month, int day)，将阳历的年月日转换为星期几。

String weekOfDate1(int year, int month, int day)
{
  int adjustment, mm, yy;
  if (year < 2000) year += 2000;
  adjustment = (14 - month) / 12;
  mm = month + 12 * adjustment - 2;
  yy = year - adjustment;
  int week = (day + (13 * mm - 1) / 5 +
              yy + yy / 4 - yy / 100 + yy / 400) % 7;
  return weekly[week];
}

        说明：本程序主要内容，来源于网络大神，如有异议，请及时联系作者。

四、项目运行结果视频展示

        本阶段TFT屏幕上部，第一行，可以显示阳历日期、星期几、农历日期；第二行显示实时网络时间（东八东，偏移量28800秒），每秒更新一次；
        中部，实时天气和明天天气预报部分，目前仍显示静态画展，没有加入实时获取天气信息的代码。
        下部，显示当前所在环境实时的温度和湿度数据，每3秒更新一次。        

WeatherClock_exalmpl4

五、项目第四专题代码下载

        百度网盘下载链接：
        https://pan.baidu.com/s/1tBrHF5KNcwBR-2-HXvNQdw?pwd=bw9e，提取码：bw9e

        参考文档
        1. NTPClient 部分源代码