Skip to content

实时时钟-rtc

描述


实时时钟,对应硬件的RTC 芯片,由纽扣电池供电,即使系统掉电,该芯片仍继续工作。父对象为device,无子对象。

事件



属性


名称功能说明脚本例子
ntpEnabled使能NTP网络时间同步服务,服务器地址由ntpServer属性指定device.rtc.ntpEnabled=true 使能网络时间同步
ntpServerNTP(Network Time Protocol)服务器地址device.rtc.ntpServer='cn.ntp.org.cn'设定网络时间同步的NTP服务器地址位cn.ntp.org.cn
syncInterval自动同步间隔,默认为60分钟device.rtc.syncInterval=1440设置同步间隔为24小时
timezone时区,默认为8,北京时间device.rtc.timezone=8 设置时区为东8区,北京时间

方法


名称功能说明脚本例子
getTime() getTime(format)读取当前时间 无参数时返回时间字符串格式为 hh:mm:ss, 如:12:01:03; 带一个参数时,参数为ms,返回自epoch(1970-1-1 00:00:00)到当前时间的毫秒数,一般用于测量时间,如:可在脚本中调用两次该函数,测量两次读取之间的时间间隔,精度为毫秒。参数为hh-mm 返回如 12:01var time=device.rtc.getTime() 读取当前时间,并存入变量time var ms=device.rtc.getTime('ms') 读取自epoch到当前时间的毫秒数(UTC时间戳)
getDateTime()读取当前日期和时间,返回字符串格式为yyyy-MM-dd hh:mm:ss var date=device.rtc.getDateTime() //读取日期和时间
getDateTime(format)读取指定格式的日期和时间,日期的格式如 yyyy-MM-dd,时间格式如 hh:mm:ss var date=device.rtc.getDateTime('MM-dd hh:mm')//读取月日时分
setDateTime(format)设置日期和时间,格式为yyyy-MM-dd hh:mm:ssdevice.rtc.setDateTime('2021-05-21 11:30:00') //设置系统日期和时间
setTime(time)设置时间,参数time为时间字符串,时间格式: hh:mm:ss(注意:模拟器不能模拟设置时间)device.rtc.setTime('01:02:00') 调整时钟时间为1点2分0秒
getDate() getDate(format)读取当前日期 无参数时返回固定格式:yyyy-MM-dd, 如:2018-01-20 有参数时返回自定义格式,如 yy-MM-dd, 返回 18-01-20var date=device.rtc.getDate() 读取当前日期,并存入变量date
setDate(date)设置日期,参数date为日期字符串,时间格式: yyyy-MM-dd (注意:模拟器不能模拟设置日期)device.rtc.setDate('2018-09-20') 调整日期为2018年9月20日
getDayOfWeek()获取星期几,1-星期一 ~ 7-星期日var day = device.rtc.getDayOfWeek() 获取星期几
addYear(count)加/减年,参数count为正表示加,为负表示减 (注意:模拟器不能模拟修改日期)device.rtc.addYear(1) 年加1
addMonth(count)加/减月,参数count为正表示加,为负表示减(注意:模拟器不能模拟修改日期)device.rtc.addMonth(1) 月加1
addDay(count)加/减日,参数count为正表示加,为负表示减(注意:模拟器不能模拟修改日期)device.rtc.addDay(1) 日加1
addHour(count)加/减时,参数count为正表示加,为负表示减(注意:模拟器不能模拟修改时间)device.rtc.addHour(1) 小时加1
addMinute(count)加/减分,参数count为正表示加,为负表示减(注意:模拟器不能模拟修改时间)device.rtc.addMinute(1) 分钟加1
addSecond(count)加/减秒,参数count为正表示加,为负表示减(注意:模拟器不能模拟修改时间)device.rtc.addSecond(1) 秒数加1
syncNetworkTime()手动同步一次网络时间(设备必须已连接互联网),时间服务器地址由ntpServer属性设置device.rtc.syncNetworkTime() 同步网络时间