esp8266 获取 NTP 实时时间

esp8266 获取 NTP 实时时间
- 开发环境：
- 背景：
- NTPClient 库的安装
- 打开库 Demo 程序
- 程序设计
- - [WIFI连接]
  - [NTP连接]
  - [示例]
  - 运行程序以后，就可以从串口助手中观察到时间：
- [NTPClient库函数描述]
- - 构造函数NTPClient ( )
  - 时间获取函数
  - 获取时间格式 - 字符串
- [C语言gmtime()函数:获取当前时间和日期]

esp8266 获取 NTP 实时时间

使用 esp8266 在线获取实时时间

开发环境：

MCU型号：ESP8266
IDE环境： Arduino IDE

背景：

NTP是网络时间协议(Network Time Protocol)，它是用来同步网络中各个计算机的时间的协议。esp8266也可以通过建立与NTP服务的连接，来获取实时时间

NTPClient 库的安装

使用NTP服务需要先安装 NTPClient 库，按组合件 Crtrl + Shift + I 调出库管理具体操作如下所示：

打开库 Demo 程序

库自带了一个建议的demo程序，方便用户快速开发，具体操作如下所示：

打开以后弹出一个窗口：

接着我们就可以将窗口缩放到合适大小，开始代码的编辑。

程序设计

[WIFI连接]

需要设置路由器的密码（Password）和名称（SSID）这样才可以esp8266才可以上网，具体操作如下：

const char *ssid     = "602";                          // 路由器名称
const char *password = "602602602";         // 路由器密码

[NTP连接]

由于全球的时间是不同的，所以需要校准时间，以北京时间为例，在创建实例的时候，见校准参数传入即可，具体操作如下：

NTPClient timeClient(ntpUDP, "ntp1.aliyun.com",60*60*8, 30*60*1000);

[示例]

修改工程以后，完整的示例代码如下所示，如果你已经安装好库，也可以直接复制以下代码到工程中，直接编译运行查看打印信息：

#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     = "602";
const char *password = "602602602";WiFiUDP ntpUDP;
NTPClient timeClient(ntpUDP, "ntp1.aliyun.com",60*60*8, 30*60*1000);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库函数描述]

构造函数NTPClient ( )

描述：NTPClient类构造函数之一，设置NTP的基本参数。
语法：NTPClient(UDP& udp, const char* poolServerName, long timeOffset, unsigned long updateInterval);
参数：WiFiUDP类对象；NTP服务器路径；NTP时间偏移（时区）；时间间隔。
用法：

NTPClient timeClient(ntpUDP, "ntp1.aliyun.com", 60*60*8, 30*60*1000);
//参数1 - ntp_udp：WiFiUDP对象
//参数2 - “ntp1.aliyun.com”：阿里云NTP服务器（任意NTP服务器都可）
//参数3 - 60*60*8 ：该参数单位为秒，60*60为东一区时间，北京时间为东八区，所以这里参数为 60*60*8
//参数4 - 30*60*1000：设置NTP更新最小时间间隔，参数单位为毫秒

时间获取函数

调用以获取当前时间为周几，小时数，分钟数，秒数等的函数。
语法：

    int getDay() const;int getHours() const;int getMinutes() const;int getSeconds() const;

描述：
getDay()函数
描述：获取当前时间星期几。
参数：无。
返回值：数字0 - 6，注意，国外将每周星期天定为一周的第一天。所以星期天的返回值为0。星期六的返回值为6。

getHours()函数
描述：获取小时数。
参数：无。
返回值：0 - 23。

getMinutes()函数
描述：获取分钟数。
参数：无。
返回值：0 - 59。

getSeconds()函数
描述：获取秒数。
参数：无。
返回值：0 - 59。
用法：

  //获取星期、时、分int weekDay = timeClient.getDay();int currentHour = timeClient.getHours();int currentMinute = timeClient.getMinutes();Serial.print("星期");Serial.print(weekDay);Serial.print("；");Serial.print(currentHour);Serial.print("点");Serial.print(currentMinute);Serial.println("分；");

获取时间格式 - 字符串

描述：获取时间格式为 hh:mm:ss 的字符串。
语法：getFormattedTime()
参数：无。
返回值：字符串 hh:mm:ss 。

  //获取时间格式 - 字符串Serial.println(timeClient.getFormattedTime());    //此命令与“将epochTime换算成年月日”冲突，会导致年月日换算不准

获取绝对时间
描述：获取自1970年1月1日到现在的时间秒数（很大一个数字）。
语法：getEpochTime()
参数：无。
返回值：时间秒数。

  //获取时间戳unsigned long epochTime = timeClient.getEpochTime();Serial.print("Epoch Time:");Serial.println(epochTime);//将epochTime换算成年月日struct tm *ptm = gmtime((time_t *)&epochTime);int monthDay = ptm->tm_mday;int currentMonth = ptm->tm_mon + 1;Serial.print(currentMonth);Serial.print("月");Serial.print(monthDay);Serial.println("日");

[C语言gmtime()函数:获取当前时间和日期]

定义函数：struct tm *gmtime(const time_t *timep);
函数说明：gmtime()将参数timep 所指的time_t 结构中的信息转换成真实世界所使用的时间日期表示方法，然后将结果由结构tm 返回。
结构tm 的定义为：
struct tm{
int tm_sec; //代表目前秒数, 正常范围为0-59, 但允许至61 秒
int tm_min; //代表目前分数, 范围0-59
int tm_hour; //从午夜算起的时数, 范围为0-23
int tm_mday; //目前月份的日数, 范围01-31
int tm_mon; //代表目前月份, 从一月算起, 范围从0-11
int tm_year; //从1900 年算起至今的年数
int tm_wday; //一星期的日数, 从星期一算起, 范围为0-6
int tm_yday; //从今年1 月1 日算起至今的天数, 范围为0-365
int tm_isdst; //日光节约时间的旗标
};
此函数返回的时间日期未经时区转换，而是UTC 时间。
返回值：返回结构tm 代表目前UTC 时间。
示例：

#include <time.h>
void setup() {Serial.begin(115200);
}
void loop() {char *wday[] = {"Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"};time_t timep;struct tm *p;time(&timep);p = gmtime(&timep);printf("%d/%d/%d ", (1900 + p->tm_year), (1 + p->tm_mon), p->tm_mday);printf("%s %d:%d:%d\n", wday[p->tm_wday], p->tm_hour, p->tm_min, p->tm_sec);delay(1000);
}

执行结果：

1969/12/31 Wed 24:0:0
1970/1/1 Thu 0:0:1
1970/1/1 Thu 0:0:2
1970/1/1 Thu 0:0:3
1970/1/1 Thu 0:0:4
1970/1/1 Thu 0:0:5