Version

Logical Day and Timeslots

Logical Day

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:

LogicalDayOffset LogicDayDuration Time range for Apr/15

00:00:00 (Default)

24:00:00 (Default)

12am Apr/15 – 12am Apr/16

-08:00:00

24:00:00 (Default)

4pm Apr/14 – 4pm Apr/15

12:00:00

24:00:00 (Default)

12pm Apr/15 – 12pm Apr/16

06:00:00

12:00:00

6am Apr/15 – 6pm Apr/15

Note: The end times listed are exclusive.

Timeslots

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: