The xamSchedule views support the ability to define the time range that defines a day. This “logical day” functionality defines the “viewport” for all views attached to the specific data manager and is controlled using the LogicalDayOffset and LogicalDayDuration properties of the xamScheduleDataManager’s Settings.
An example of the logical day in use is to consider when you might want to make a day’s cutoff 4am instead of 12am. Consider a scheduling application for a TV station where the station’s ‘day’ begins at 4am to accommodate a programming schedule that considers the time from midnight to 4am as part of the previous day.
For controls like xamScheduleView and xamDayView this will affect which timeslots are displayed for each date in its VisibleDates collection. For xamMonthView, this will affect which activities are displayed within each day in the control. The following table demonstrates the effects of these properties on the time range for a given date:
Note: The end times listed are exclusive.
Each day in the xamDayView and xamScheduleView is divided into timeslots. The initial duration of the timeslots is 15 minutes and can be altered by changing the TimeslotInterval property on each view independently. The allowed values are between 1 second and 1 day.
Another way to restrict the time slots that are displayed is via the ShowWorkinghoursOnly property on these controls. When set to true, the control attempts to exclude all timeslots that are outside of the working hour definitions. The WorkingHoursSource property of the view determines which Resources are evaluated when resolving the working hours and has the following values:
CurrentUser – the current user set in the DataManager’s CurrentUserId property.
AllResourcesInGroup – a union of all working hours set in the resources within the CalendarGroupsResolved property of the view.