实时时钟-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 <br> 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() 同步网络时间 |