ntp
===

.. _ntp-1:

ntp
---

模块功能：网络授时.

重要提醒！！！！！！

本功能模块采用多个免费公共的NTP服务器来同步时间

并不能保证任何时间任何地点都能百分百同步到正确的时间

所以，如果用户项目中的业务逻辑严格依赖于时间同步功能

则不要使用使用本功能模块，建议使用自己的应用服务器来同步时间

参考 http://ask.openluat.com/article/912 加深对授时功能的理解

ntp.ntpTime(ts, fnc, fun)
~~~~~~~~~~~~~~~~~~~~~~~~~

同步时间，每个NTP服务器尝试3次，超时8秒,适用于被任务函数调用

-  参数

========== ======================
传入值类型 释义
========== ======================
number     ts,每隔ts小时同步1次
function   fnc,同步成功后回调函数
function   fun,同步成功前回调函数
========== ======================

-  返回值

nil

-  例子

.. code:: lua

   ntp.ntpTime() -- 只同步1次
   ntp.ntpTime(1) -- 1小时同步1次
   ntp.ntpTime(nil,fnc) -- 只同步1次，同步成功后执行fnc()
   ntp.ntpTime(24,fnc) -- 24小时同步1次，同步成功后执行fnc()

--------------

ntp.timeSync(ts, fnc, fun)
~~~~~~~~~~~~~~~~~~~~~~~~~~

自动同步时间任务，适合独立执行.

重要提醒！！！！！！本功能模块采用多个免费公共的NTP服务器来同步时间并不能保证任何时间任何地点都能百分百同步到正确的时间所以，如果用户项目中的业务逻辑严格依赖于时间同步功能则不要使用使用本功能模块，建议使用自己的应用服务器来同步时间

-  参数

========== ======================
传入值类型 释义
========== ======================
number     ts,每隔ts小时同步1次
function   fnc,同步成功后回调函数
function   fun,同步成功前回调函数
========== ======================

-  返回值

nil

-  例子

.. code:: lua

   ntp.timeSync() -- 只同步1次
   ntp.timeSync(1) -- 1小时同步1次
   ntp.timeSync(nil,fnc) -- 只同步1次，同步成功后执行fnc()
   ntp.timeSync(24,fnc) -- 24小时同步1次，同步成功后执行fnc()

--------------