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 で設定されます。