ntptime --- シンプルな NTP クライアント

このモジュールは、Network Time Protocol (NTP) 向けの小さなクライアントを提供します。インターネット上のタイムサーバーから現在の UTC 時刻を取得し、必要に応じてオンボードのリアルタイムクロックを設定するのに役立ちます。NTP サーバーへ単一の UDP リクエストを送り、返された 64 ビットのタイムスタンプをデコードします。

このモジュールは動作するネットワーク接続を前提とします。32 ビットのワイヤ上タイムスタンプは 2036 年の NTP ロールオーバーに対して自動的に補正されるため、この実装は 2160 年 2 月まで有効です。

関数

ntptime.time() int

設定された NTP サーバー (host) に問い合わせ、MicroPython エポックからの経過秒数を表す整数として現在の UTC 時刻を返します。

MicroPython エポックは time.gmtime() を使って実行時に検出されます。1970 年 (Unix) と 2000 年の両方のエポックがサポートされており、それ以外のエポックの場合は Exception が送出されます。

ネットワークエラーは呼び出し元に伝播します。基盤となるソケットは戻る前に常にクローズされます。

ntptime.settime() None

time() を使って現在時刻を取得し、machine.RTC を介してオンボード RTC をそれに合わせて設定します。

MicroPython にはタイムゾーンのサポートがないことに注意してください。RTC は常に UTC で設定されます。

定数

ntptime.host: str

問い合わせ先となる NTP サーバーのホスト名。デフォルトは "pool.ntp.org" です。上書きするには実行時に再代入します。例: ntptime.host = "time.google.com"

ntptime.timeout: int

NTP の UDP リクエストに適用されるソケットタイムアウト(秒)。デフォルトは 1 です。低速または高レイテンシのネットワークでは値を増やしてください。