ESP32 環境監測 05:用 NTP 取得正確時間並加上時間戳記

這是「ESP32 環境監測」系列的第 5 篇。上一篇我們把溫濕度送進了 Google 試算表,但時間是 Google 伺服器收到資料的時間。這一篇要讓 ESP32 自己透過 NTP 取得標準時間,替每一筆資料加上可靠的時間戳記。

本篇重點
・了解 NTP 與為什麼 ESP32 需要它
・讓 ESP32 同步台灣時間並格式化顯示
・把裝置端的時間戳記送進試算表,取代伺服器時間
難度:入門到中等 預估時間:40 分鐘

一、為什麼需要時間?

感測資料如果沒有時間,就只是一堆數字。後面要畫趨勢圖、算每日平均、找出異常,都需要知道「這筆資料是什麼時候量的」。

上一篇用的是伺服器時間,大多數時候已經夠用,但有兩個限制:

  • 時間是收到的時間,不是量測的時間。如果之後做成「先暫存、網路恢復再補送」,所有資料會擠在同一時間。
  • 裝置自己不知道現在幾點。想讓裝置在特定時段才動作、或在本機顯示時間,就必須自己取得時間。

ESP32 沒有電池供電的時鐘,每次斷電重開,時間都會歸零(顯示為 1970 年),所以每次開機都要重新對時。

二、NTP 是什麼?

NTP(Network Time Protocol,網路時間協定)是讓裝置向時間伺服器詢問標準時間的協定。ESP32 連上網路後,向 NTP 伺服器取得時間,再校正內部時鐘。之後它也會定期自動重新校時,修正長時間運作的誤差。

ESP32 透過 NTP 對時 ESP32 內部時鐘 NTP 伺服器 time.stdtime.gov.tw (標準時間來源) ① 詢問現在幾點 ② 回傳標準時間 ③ 每筆資料附上時間戳記

三、材料準備

  • 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?
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 量測的時間。

為什麼要判斷 1600000000?
這個數字大約是 2020 年 9 月的 Epoch 秒數。對時失敗時,ESP32 的時間會停在 1970 年附近,數值很小。用這個門檻可以避免把 1970 年的錯誤時間寫進試算表。

六、驗證

  1. 上傳整合後的程式,開啟序列埠監控視窗。
  2. 確認有「對時成功」,以及 HTTP 狀態碼:200 回應:ok。
  3. 開啟試算表,確認新增的那一列時間與你的實際時間一致。
  4. 對照測試:先用手機的時間對照試算表第一欄,兩者差距應在幾秒之內。

七、常見問題

  • 時間顯示 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 試算表 | 下一篇:把資料畫成圖表

留言

熱門文章