ESP32 環境監測 05:用 NTP 取得正確時間並加上時間戳記
這是「ESP32 環境監測」系列的第 5 篇。上一篇我們把溫濕度送進了 Google 試算表,但時間是 Google 伺服器收到資料的時間。這一篇要讓 ESP32 自己透過 NTP 取得標準時間,替每一筆資料加上可靠的時間戳記。
・了解 NTP 與為什麼 ESP32 需要它
・讓 ESP32 同步台灣時間並格式化顯示
・把裝置端的時間戳記送進試算表,取代伺服器時間
難度:入門到中等 預估時間:40 分鐘
一、為什麼需要時間?
感測資料如果沒有時間,就只是一堆數字。後面要畫趨勢圖、算每日平均、找出異常,都需要知道「這筆資料是什麼時候量的」。
上一篇用的是伺服器時間,大多數時候已經夠用,但有兩個限制:
- 時間是收到的時間,不是量測的時間。如果之後做成「先暫存、網路恢復再補送」,所有資料會擠在同一時間。
- 裝置自己不知道現在幾點。想讓裝置在特定時段才動作、或在本機顯示時間,就必須自己取得時間。
ESP32 沒有電池供電的時鐘,每次斷電重開,時間都會歸零(顯示為 1970 年),所以每次開機都要重新對時。
二、NTP 是什麼?
NTP(Network Time Protocol,網路時間協定)是讓裝置向時間伺服器詢問標準時間的協定。ESP32 連上網路後,向 NTP 伺服器取得時間,再校正內部時鐘。之後它也會定期自動重新校時,修正長時間運作的誤差。
三、材料準備
- ESP32 開發板,並能連上 WiFi(第 3 篇)
- 第 2 到 4 篇的 DHT11 與試算表流程(整合部分會用到)
先做純對時的實驗,不需要任何感測器。
四、對時並顯示時間
#include <WiFi.h>
#include <time.h>
const char* WIFI_SSID = "你的WiFi名稱";
const char* WIFI_PASSWORD = "你的WiFi密碼";
// 台灣為 UTC+8,沒有日光節約時間
const long GMT_OFFSET_SEC = 8 * 3600;
const int DAYLIGHT_OFFSET_SEC = 0;
bool connectWiFi() {
WiFi.mode(WIFI_STA);
WiFi.begin(WIFI_SSID, WIFI_PASSWORD);
unsigned long start = millis();
while (WiFi.status() != WL_CONNECTED && millis() - start < 15000) {
delay(500);
Serial.print(".");
}
Serial.println();
return WiFi.status() == WL_CONNECTED;
}
bool syncTime() {
// 依序嘗試:台灣國家時間頻率實驗室、國際 NTP 池
configTime(GMT_OFFSET_SEC, DAYLIGHT_OFFSET_SEC, "time.stdtime.gov.tw", "pool.ntp.org");
struct tm timeinfo;
return getLocalTime(&timeinfo, 10000); // 最多等 10 秒
}
void setup() {
Serial.begin(115200);
delay(1000);
if (!connectWiFi()) {
Serial.println("WiFi 連線失敗");
return;
}
Serial.println("WiFi 已連線");
if (syncTime()) {
Serial.println("對時成功");
} else {
Serial.println("對時失敗,請檢查網路");
}
}
void loop() {
struct tm timeinfo;
if (getLocalTime(&timeinfo)) {
char buf[32];
strftime(buf, sizeof(buf), "%Y-%m-%d %H:%M:%S", &timeinfo);
Serial.print("現在時間:");
Serial.print(buf);
time_t now = time(nullptr);
Serial.print(" Epoch 秒數:");
Serial.println((unsigned long)now);
} else {
Serial.println("尚未取得時間");
}
delay(1000);
}
程式說明
configTime():設定時區偏移與 NTP 伺服器,ESP32 會在背景自動去對時。GMT_OFFSET_SEC是與 UTC 相差的秒數,台灣是 8 小時,也就是 28800 秒。getLocalTime():取得本地時間,成功回傳 true。這裡也順便當作「對時完成」的判斷,最多等 10 秒。strftime():把時間格式化成文字。%Y-%m-%d %H:%M:%S會輸出像 2026-11-05 14:30:00 這樣的格式。time(nullptr):取得 Epoch 時間,也就是從 1970 年 1 月 1 日 0 時 0 分 0 秒(UTC)起算的秒數。
Epoch 秒數是一個與時區無關的整數,在程式之間傳遞時間時最不容易出錯。我們會把它當成時間戳記送到雲端,再由接收端轉換成當地時間,避免兩邊時區設定不一致造成的誤差。
上傳後,序列埠應該會顯示類似:
WiFi 已連線 對時成功 現在時間:2026-11-05 14:30:00 Epoch 秒數:1793860200
實際數值會依你執行的時間而不同,請對照手機或電腦的時間,確認一致。
五、整合到上一篇:把時間戳記送進試算表
現在讓上一篇的流程改用裝置端的時間。需要修改兩個地方:Apps Script 接收端與 ESP32 程式。
1. 修改 Apps Script
把 doGet 中寫入資料的部分,改成優先使用 ESP32 送來的時間戳記;沒有帶或不合理時,才退回使用伺服器時間,這樣舊版程式也不會壞掉。
const TOKEN = '請換成你自己的密碼';
const SHEET_NAME = 'data';
function doGet(e) {
const p = e.parameter;
if (p.token !== TOKEN) {
return ContentService.createTextOutput('unauthorized');
}
const temp = Number(p.temp);
const hum = Number(p.hum);
if (isNaN(temp) || isNaN(hum)) {
return ContentService.createTextOutput('bad data');
}
// 優先用裝置端時間戳記(Epoch 秒),數值不合理就退回伺服器時間
const ts = Number(p.ts);
const time = (ts > 1600000000) ? new Date(ts * 1000) : new Date();
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(SHEET_NAME);
if (!sheet) {
return ContentService.createTextOutput('sheet not found');
}
sheet.appendRow([time, temp, hum]);
return ContentService.createTextOutput('ok');
}
改完程式後,要到「部署 → 管理部署作業」,編輯現有部署並選擇「新版本」,修改才會生效。
2. 修改 ESP32 程式
在第 4 篇的程式上做三處修改:
(a) 檔案最上方加入 #include <time.h>,並加上時區設定:
#include <time.h> const long GMT_OFFSET_SEC = 8 * 3600; const int DAYLIGHT_OFFSET_SEC = 0;
(b) 在 setup() 的 connectWiFi(); 之後加入對時:
configTime(GMT_OFFSET_SEC, DAYLIGHT_OFFSET_SEC, "time.stdtime.gov.tw", "pool.ntp.org");
struct tm timeinfo;
if (getLocalTime(&timeinfo, 10000)) {
Serial.println("對時成功");
} else {
Serial.println("對時失敗,將使用伺服器時間");
}
(c) 在 sendToSheet() 中,組合網址之後,加上時間戳記(有取得有效時間才加):
String url = String(GAS_URL) + "?token=" + TOKEN +
"&temp=" + String(temp, 1) +
"&hum=" + String(hum, 1);
// 加上裝置端時間戳記(Epoch 秒),尚未對時成功就不加
time_t now = time(nullptr);
if (now > 1600000000) {
url += "&ts=" + String((unsigned long)now);
}
其餘部分不用改。上傳後,試算表第一欄的時間就會是 ESP32 量測的時間。
這個數字大約是 2020 年 9 月的 Epoch 秒數。對時失敗時,ESP32 的時間會停在 1970 年附近,數值很小。用這個門檻可以避免把 1970 年的錯誤時間寫進試算表。
六、驗證
- 上傳整合後的程式,開啟序列埠監控視窗。
- 確認有「對時成功」,以及
HTTP 狀態碼:200 回應:ok。 - 開啟試算表,確認新增的那一列時間與你的實際時間一致。
- 對照測試:先用手機的時間對照試算表第一欄,兩者差距應在幾秒之內。
七、常見問題
- 時間顯示 1970 年:對時沒有成功。確認 WiFi 已連上,並再試一次。
- 時間差了 8 小時:檢查
GMT_OFFSET_SEC是否設為8 * 3600。試算表第一欄若與預期差 8 小時,也檢查試算表和 Apps Script 的時區設定。 - 對時失敗,但 WiFi 正常:NTP 使用 UDP 的 123 埠,部分學校或公司網路會擋掉。可以換成手機熱點測試,或在
configTime()換一個 NTP 伺服器,例如time.google.com。 - 剛開機一小段時間時間不準:要等 NTP 回應後才會校正,所以程式要等對時成功再開始送資料。
八、延伸挑戰
- 讓程式只在早上 8 點到晚上 10 點之間才傳送資料(用
timeinfo.tm_hour判斷)。 - 在序列埠印出開機後經過了多久(
millis())與目前的實際時間,觀察兩者的差別。
下一篇預告
現在試算表裡已經有了時間、溫度與濕度,而且時間是可靠的。下一篇我們要把這些資料畫成圖表,直接觀察溫濕度隨時間的變化。
系列:ESP32 環境監測
目錄:系列總整理 | 上一篇:用 HTTP 把資料送到 Google 試算表 | 下一篇:把資料畫成圖表
留言
張貼留言