
给项目里的数据打时间戳,很多人第一反应是加个RTC模块,DS1307、DS3231这些型号立马冒出来。但其实只要ESP32能连上Wi-Fi,用NTP从网络上对时,一根额外的硬件都不用加,date和时间全都能拿到。这篇把它从头到尾理清楚:原理、configTime的参数怎么填、代码长什么样、串口输出怎么读,最后聊聊掉电以后怎么处理和实际打时间戳的用法。
NTP是什么,为什么可以不用RTC
NTP全称Network Time Protocol,网络时间协议,专门用来在网络里的设备之间同步时钟。互联网上有公开免费的NTP服务器集群,比如pool.ntp.org,任何设备都可以当客户端去请求时间。ESP32在这里就扮演NTP客户端的角色,向服务器要一次时间,之后靠内部晶振维持走时。
和RTC模块的路线对比一下:DS1307这类芯片靠纽扣电池在掉电后维持计时,适合没有网络的环境;而NTP路线的前提是设备能上网,只要联网,时间就是权威服务器给的,不存在晶振漂移累积误差的问题。两条路线各有适用场景,站内之前已经写过好几篇RTC硬件的教程,这篇专门讲无RTC的网络授时,正好互补。
这个做法最大的好处是省事:不用装任何额外库,标准库里的time.h就够了,也不用接任何线,写几行代码就能跑。

configTime三个参数与时区怎么填
ESP32的Arduino核心里有一个现成函数configTime,原型是configTime(gmtOffset_sec, daylightOffset_sec, ntpServer),三个参数各管一件事。第一个是时区相对GMT的偏移秒数,第二个是夏令时偏移秒数,第三个是NTP服务器地址。
gmtOffset_sec这个变量定义的是你的时区和GMT之间相差的秒数。原教程作者住在葡萄牙,偏移填0;国内玩家要填东八区,也就是8乘3600等于28800秒。daylightOffset_sec是夏令时补偿,一般是一个小时即3600秒,但国内不实行夏令时,直接填0就行,这一步是很多教程照抄外国代码时最容易搞错的地方。
服务器地址用pool.ntp.org没有任何问题,它是一个由多台时间服务器组成的集群,免费开放。国内如果嫌延迟高,也可以换成cn.pool.ntp.org或ntp.aliyun.com这类镜像,调用方式完全一样。
完整代码
下面这份代码来自Random Nerd Tutorials的ESP32 NTP教程,基于time.h库自带示例整理,整体逻辑是连Wi-Fi、对一次时、然后每秒在串口打印当前日期时间。把ssid和password换成你自己的Wi-Fi信息就能直接烧录。
/*
Rui Santos
Complete project details at https://RandomNerdTutorials.com/esp32-date-time-ntp-client-server-arduino/
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files.
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
*/
#include "WiFi.h"
#include "time.h"
const char* ssid = "REPLACE_WITH_YOUR_SSID";
const char* password = "REPLACE_WITH_YOUR_PASSWORD";
const char* ntpServer = "pool.ntp.org";
const long gmtOffset_sec = 0;
const int daylightOffset_sec = 3600;
void setup(){
Serial.begin(115200);
// Connect to Wi-Fi
Serial.print("Connecting to ");
Serial.println(ssid);
WiFi.begin(ssid, password);
while (WiFi.status() != WL_CONNECTED) {
delay(500);
Serial.print(".");
}
Serial.println("");
Serial.println("WiFi connected.");
// Init and get the time
configTime(gmtOffset_sec, daylightOffset_sec, ntpServer);
printLocalTime();
//disconnect WiFi as it's no longer needed
WiFi.disconnect(true);
WiFi.mode(WIFI_OFF);
}
void loop(){
delay(1000);
printLocalTime();
}
void printLocalTime(){
struct tm timeinfo;
if(!getLocalTime(&timeinfo)){
Serial.println("Failed to obtain time");
return;
}
Serial.println(&timeinfo, "%A, %B %d %Y %H:%M:%S");
Serial.print("Day of week: ");
Serial.println(&timeinfo, "%A");
Serial.print("Month: ");
Serial.println(&timeinfo, "%B");
Serial.print("Day of Month: ");
Serial.println(&timeinfo, "%d");
Serial.print("Year: ");
Serial.println(&timeinfo, "%Y");
Serial.print("Hour: ");
Serial.println(&timeinfo, "%H");
Serial.print("Hour (12 hour format): ");
Serial.println(&timeinfo, "%I");
Serial.print("Minute: ");
Serial.println(&timeinfo, "%M");
Serial.print("Second: ");
Serial.println(&timeinfo, "%S");
Serial.println("Time variables");
char timeHour[3];
strftime(timeHour,3, "%H", &timeinfo);
Serial.println(timeHour);
char timeWeekDay[10];
strftime(timeWeekDay,10, "%A", &timeinfo);
Serial.println(timeWeekDay);
Serial.println();
}
有一点要说明:原代码里WiFi.h的头文件是尖括号写法,站点发布系统会剥掉尖括号内容,所以这里统一改成了引号写法#include "WiFi.h",在Arduino工具链下两种写法对库的搜索路径是等价的,编译结果没有区别。其余代码逐字符原样搬运,一个缩进都没动。
代码逐段拆解
开头引入两个库:WiFi.h负责联网,time.h负责时间处理,后者是编译器自带的,不用额外安装。ssid和password填你家路由器的名字和密码,ESP32靠它们接入互联网才能摸到NTP服务器。
setup()里先以115200波特率初始化串口,然后WiFi.begin连网,用while循环卡住直到WL_CONNECTED。连上之后立刻调用configTime(gmtOffset_sec, daylightOffset_sec, ntpServer)完成对时配置,再打印一次本地时间。有个细节值得注意:示例在对完时后直接WiFi.disconnect(true)并把WiFi模式关掉,因为时间已经同步到内部RTC,断网不影响走时。
printLocalTime()里先声明一个struct tm结构体timeinfo,这是C标准里拆分好的日历时间结构,成员包括tm_sec、tm_min、tm_hour、tm_mday、tm_year等,年是从1900起算的年份偏移,星期是从周日起算的天数。getLocalTime(&timeinfo)尝试填充这个结构体,失败就打印Failed to obtain time并返回,典型失败原因是刚开机还没对上时。
串口输出怎么读
烧录后按一下ESP32的Enable键,串口监视器波特率调到115200,就能看到每秒刷新一行完整日期时间,格式类似Saturday, March 07 2020 18:30:45,下面还会逐项列出星期、月份、日、年、时、分、秒,甚至十二小时制的表示。

格式化输出靠的是strftime风格的控制符:%A是星期全称,%B是月份全称,%d是几号,%Y是四位年份,%H和%M、%S分别是时分秒,%I是十二小时制的小时。如果想存进变量而不是直接打印,示例里也给了标准写法:建一个char数组,比如存小时用timeHour[3],两个字符加一个字符串结束符;存星期用timeWeekDay[10],因为最长的Saturday有九个字符。然后用strftime(timeHour,3,"%H",&timeinfo)把值拷进去。
其他控制符还能取更多花样:%b是缩写月名,%a是缩写星期,%U是一年中的第几周(以第一个周日为第一周的开始)。需要更冷门的格式去查strftime的手册就行,不用死记。
掉电重取与打时间戳的实际用法
先说清楚一个边界:这套方案只在ESP32能上网时有效。设备重启之后内部时间会归零,所以实际项目里的常规做法是每次启动都连一次网对时,对完再断开,就像示例代码那样,Wi-Fi只在对时那几秒钟工作,功耗和占用都很小。
如果你做的数据记录项目本身就要长期联网上传数据,那就更简单了,configTime在setup里调一次,之后每次读传感器时顺手getLocalTime拿时间戳。把传感器读数和时间拼成一行写进SD卡或者上传云端,事后分析才有时间轴可看。一个常见的组合是"%Y-%m-%d %H:%M:%S",输出形如2026-11-19 09:30:00,Excel和各类日志系统都直接认。
另一种情况是设备压根没有网络,比如野外部署的记录仪,那NTP就帮不上忙了,老老实实上DS1307这类RTC模块才是正解,掉电靠电池维持计时。两种方案不是二选一的关系,有些项目两者都装:平时靠NTP校准RTC,断网时靠RTC兜底。
对周末才有空折腾的玩家来说,这个技能性价比很高:不用买任何东西,十来行代码,就能让温湿度记录、浇花日志这些小项目拥有准确的时间轴。下次做数据记录项目时,记得第一件事就是对时。











这个方法我上个月给阳台的温湿度记录仪用上了,八行代码搞定,比之前买的DS3231模块省事。就是有一点提醒后面的人:家里路由器断电重启之后,如果设备当时正好在循环里打印时间,得等重连Wi-Fi再configTime一次,不然打印的还是旧时间。另外国内记得gmtOffset填28800,我第一次照抄外网的0,时间差了八小时。
国内直接用ntp.aliyun.com,延迟明显比pool.ntp.org低,代码一行都不用改。
挺好,不用买模块是真的香,我的浇花记录仪马上安排。
长知识了,原来对完时断Wi-Fi也能继续走,内部有RTC兜底啊。