实时时钟-rtc
描述
实时时钟，对应硬件的RTC 芯片，由纽扣电池供电，即使系统掉电，该芯片仍继续工作。父对象为device.io，无子对象。
事件
无
属性
| 名称 | 功能说明 | 脚本例子 |
|---|---|---|
| ntpEnabled | 使能NTP网络时间同步服务，服务器地址由ntpServer属性指定 | device.io.rtc.ntpEnabled=true 使能网络时间同步 |
| ntpServer | NTP(Network Time Protocol)服务器地址 | device.io.rtc.ntpServer='cn.ntp.org.cn'设定网络时间同步的NTP服务器地址位cn.ntp.org.cn |
| syncInterval | 自动同步间隔，默认为60分钟 | device.io.rtc.syncInterval=1440设置同步间隔为24小时 |
| timezone | 时区，默认为8，北京时间 | device.io.rtc.timezone=8 设置时区为东8区，北京时间 |
方法
| 名称 | 功能说明 | 脚本例子 |
|---|---|---|
| getTime() getTime(format) | 读取当前时间 无参数时返回时间字符串格式为 hh:mm:ss, 如：12:01:03；带一个参数时，参数为ms，返回自epoch(1970-1-100:00:00)到当前时间的毫秒数，一般用于测量时间，如：可在脚本中调用两次该函数，测量两次读取之间的时间间隔，精度为毫秒。参数为hh-mm 返回如12:01 | var time=device.io.rtc.getTime() 读取当前时间，并存入变量time var ms=device.io.rtc.getTime('ms') 读取自epoch到当前时间的毫秒数(UTC时间戳) |
| getDateTime() | 读取当前日期和时间，返回字符串格式为yyyy-MM-dd hh:mm:ss | var date=device.io.rtc.getDateTime() //读取日期和时间 |
| getDateTime(format) | 读取指定格式的日期和时间，日期的格式如 yyyy-MM-dd，时间格式如 hh:mm:ss | var date=device.io.rtc.getDateTime('MM-dd hh:mm')//读取月日时分 |
| setDateTime(format) | 设置日期和时间，格式为yyyy-MM-dd hh:mm:ss | device.io.rtc.setDateTime('2021-05-21 11:30:00') //设置系统日期和时间 |
| setTime(time) | 设置时间，参数time为时间字符串，时间格式： hh:mm:ss（注意：模拟器不能模拟设置时间） | device.io.rtc.setTime('01:02:00') 调整时钟时间为1点2分0秒 |
| getDate() getDate(format) | 读取当前日期 无参数时返回固定格式：yyyy-MM-dd， 如：2018-01-20 有参数时返回自定义格式，如 yy-MM-dd, 返回 18-01-20 | var date=device.io.rtc.getDate() 读取当前日期，并存入变量date |
| setDate(date) | 设置日期，参数date为日期字符串，时间格式： yyyy-MM-dd （注意：模拟器不能模拟设置日期） | device.io.rtc.setDate('2018-09-20') 调整日期为2018年9月20日 |
| getDayOfWeek() | 获取星期几，1-星期一 ~ 7-星期日 | var day = device.io.rtc.getDayOfWeek() 获取星期几 |
| addYear(count) | 加/减年，参数count为正表示加，为负表示减 （注意：模拟器不能模拟修改日期） | device.io.rtc.addYear(1) 年加1 |
| addMonth(count) | 加/减月，参数count为正表示加，为负表示减（注意：模拟器不能模拟修改日期） | device.io.rtc.addMonth(1) 月加1 |
| addDay(count) | 加/减日，参数count为正表示加，为负表示减（注意：模拟器不能模拟修改日期） | device.io.rtc.addDay(1) 日加1 |
| addHour(count) | 加/减时，参数count为正表示加，为负表示减（注意：模拟器不能模拟修改时间） | device.io.rtc.addHour(1) 小时加1 |
| addMinute(count) | 加/减分，参数count为正表示加，为负表示减（注意：模拟器不能模拟修改时间） | device.io.rtc.addMinute(1) 分钟加1 |
| addSecond(count) | 加/减秒，参数count为正表示加，为负表示减（注意：模拟器不能模拟修改时间） | device.io.rtc.addSecond(1) 秒数加1 |
| syncNetworkTime() | 手动同步一次网络时间（设备必须已连接互联网），时间服务器地址由ntpServer属性设置 | device.io.rtc.syncNetworkTime() 同步网络时间 |