openHAB

Class: OpenHAB::Core::Events::TimerEvent

Inherits:
AbstractEvent show all
Defined in:
lib/openhab/core/events/timer_event.rb

Overview

Adds methods to core openHAB TimerEvent to make it more natural in Ruby

This event can be triggered by a DateTimeTrigger, cron, or TimeOfDay trigger.

Since:

  • openHAB 4.0

Instance Attribute Summary collapse

Attributes inherited from AbstractEvent

#attachment, #inputs

Method Summary

Methods inherited from AbstractEvent

#inspect, #payload

Instance Attribute Details

#cron_expression ⇒ String? (readonly)

Returns The cron expression that triggered this event. nil when this event wasn't triggered by a cron trigger.

Returns:

  • (String, nil) —

    The cron expression that triggered this event. nil when this event wasn't triggered by a cron trigger.

Since:

  • openHAB 4.0



23
24
25
 
# File 'lib/openhab/core/events/timer_event.rb', line 23

def cron_expression
  payload&.[](:cronExpression)
end

#item ⇒ Item? (readonly)

Returns The DateTime item that triggered this event. nil when this event wasn't triggered by a DateTimeItem trigger.

Returns:

  • (Item, nil) —

    The DateTime item that triggered this event. nil when this event wasn't triggered by a DateTimeItem trigger.

Since:

  • openHAB 4.0



32
33
34
 
# File 'lib/openhab/core/events/timer_event.rb', line 32

def item
  payload&.[](:itemName)&.then { |item_name| EntityLookup.lookup_item(item_name) }
end

#time ⇒ LocalTime? (readonly)

Returns The configured time for this TimeOfDay trigger event. nil when this event wasn't triggered by a TimeOfDay trigger.

Returns:

  • (LocalTime, nil) —

    The configured time for this TimeOfDay trigger event. nil when this event wasn't triggered by a TimeOfDay trigger.

Since:

  • openHAB 4.0



41
42
43
 
# File 'lib/openhab/core/events/timer_event.rb', line 41

def time
  payload&.[](:time)&.then { |time| LocalTime.parse(time) }
end