Reminder.DstBehavior Property
OBSOLETE
Use the SchedulerStorage.ReminderDstBehaviorType property instead
Sets the reminder behavior if it falls on the Daylight Saving Time shift. Use the SchedulerStorageBase.ReminderDstBehaviorType property instead.
Namespace: DevExpress.XtraScheduler
Assembly: DevExpress.XtraScheduler.v24.1.Core.dll
NuGet Package: DevExpress.Scheduler.Core
Declaration
[Obsolete("Use the SchedulerStorage.ReminderDstBehaviorType property instead ", false)]
public static DstBehaviorType DstBehavior { get; set; }Property Value
| Type | Description |
|---|---|
| DstBehaviorType | One of the DstBehaviorType enumeration values. |
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 DstBehavior 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 DstBehavior 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. |