09. RTC

rtcオブジェクトは、RTCアラーム機能を提供する組み込みオブジェクトです。

機能概要:

  • 指定した時刻にアラームイベントを発生させる機能を提供します。

制限事項:

  • 使用可能なアラームは1本です。


rtc Global Object

Methods()/PropertiesSummaryVersionNote
rtc.setAlarm()アラーム発生時刻を設定します。
rtc.stopAlarm()アラームを解除します。


Details

rtc.setAlarm(rtcAlarm[,callback])

アラーム発生時刻を設定します。
アラーム発生時にコールバック処理を実行します。
アラームは解除されるまで発生します。
本メソッドは、多重使用できません。
別の時刻を設定する場合は一度解除させる必要があります。

NameTypeM/OSummaryNote
rtcAlarmObjectmandatoryアラーム発生時刻設定
hour : {number}
アラーム発生時刻[時]
設定範囲: 0～23
minute : {number}
アラーム発生時刻[分]
設定範囲: 0～59
second : {number}
アラーム発生時刻[秒]
設定範囲: 0～59
timeout : {number} (※1)		※1: 使用しません。
callback()functionmandatoryアラーム発生時にコールバック処理を実行します。
returnundefined--異常が発生した時は、例外となります。

rtc.stopAlarm()

アラームを解除します。

NameTypeM/OSummaryNote
returnundefined--


オブジェクトの使用例

Sample1

アラームを発生させるサンプルです。
現在時刻を取得し、その時点から20秒後にRTCアラームを発生させます。

var MAX_COUNT = 5;
var count = MAX_COUNT;
var set_date;
var rtc_time;

var perAlarm = function() {
    rtc.stopAlarm();
    count--;
    print('alarm: count = ' + count);
    set_date = new Date();
    print('Now time: ' + set_date.toString());
    if(count > 0) {
        set_date.setSeconds(set_date.getSeconds() + 20);
        rtc_time = {    
            hour: set_date.getHours(), 
            minute: set_date.getMinutes(),
            second: set_date.getSeconds()
        };
        rtc.setAlarm(rtc_time, perAlarm);
    }
}

perAlarm();


Updated: 2022-08-31
← 前次 →