SchedulerStorageBase.ReminderDstBehaviorType Property
Gets or sets the reminder’s behavior if the reminder alert falls within the interval that actually doesn’t exist because of the Daylight Saving Time shift.
Namespace: DevExpress.XtraScheduler
Assembly: DevExpress.XtraScheduler.v24.1.Core.Desktop.dll
NuGet Package: DevExpress.Scheduler.CoreDesktop
Declaration
Property Value
Type | Description |
---|---|
DstBehaviorType | A DstBehaviorType enumeration value that specifies at what time the alert is triggered. |
Available values:
Name | Description |
---|---|
AlertAfterDstShift | Unlike the Alert value, the AlertAfterDstShift calculates the alert time using the reminder time before the actual start of the appointment. If the calculated alert time falls into a non-existing time interval, the alert is triggered at the end of the Daylight Saving Time shift. |
Update | Triggers the reminder at the specified time before the event. |
Dismiss | Dismisses the reminder. |
Alert | If the appointment start time or the projected alert time falls into a non-existing time interval, the alert is triggered at the end of the Daylight Saving Time shift. Unlike the AlertAfterDstShift value, the alert time is not recalculated if the appointment start time falls in the DST shift and the alert is always triggered at the end of the DST shift. |
Remarks
This property enables you to correct the reminder’s behavior for a series of recurring appointments if an occurrence in a series falls in a DST shift (in the United States, it is the interval between 2:00:00 and 2:59:59 local time on the Daylight Saving Time start date, the time interval that actually doesn’t exist). By default, the property is set to DstBehaviorType.AlertAfterDstShift and if the alert time falls in the DST shift, an alert is invoked at the end of the DST shift, i.e. at 3 AM in the United States.
To invoke the reminder alert at the specified time before the actual start of an appointment, set the ReminderDstBehaviorType property to the DstBehaviorType.Update value. The alert time will be updated as required.
To dismiss the reminder when it falls in the DST shift, use the DstBehaviorType.Dismiss property value.
Consider two scenarios with different settings for the ReminderDstBehaviorType property.
Scenario 1:
Appointment.Start = 2:05, ReminderBase.TimeBeforeStart = 6 min.
Value | Behavior |
---|---|
DstBehaviorType.Dismiss | the reminder will be dismissed |
DstBehaviorType.AlertAfterDstShift | the alert will be triggered at 3:00 AM. |
DstBehaviorType.Update | the alert will be triggered at 1:59 AM. |
Scenario 2:
Appointment.Start = 2:30, ReminderBase.TimeBeforeStart = 6 min.
Value | Behavior |
---|---|
DstBehaviorType.Dismiss | the reminder will be dismissed |
DstBehaviorType.AlertAfterDstShift | the alert will be triggered at 3:24 AM. |
DstBehaviorType.Update | the alert will be triggered at 3:24 AM. |