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

results matching ""

    No results matching ""