Calendar

Calendar class

Inherits: Aspose::Tasks::ICalendar

Represents a calendar used in a project.

How to create simple calendar from scratch.

[C#]
// create empty calendar
Calendar calendar = new Calendar("New calendar");
// adds default working days (8 working hours from 9:00 to 17:00)
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Monday));
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Tuesday));
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Wednesday));
// create new new working day
WeekDay myWeekDay = new WeekDay(DayType.Thursday);
// Sets working time. Only time part of DateTime is important
    WorkingTime wt1 = new WorkingTime();
    wt1.FromTime = new DateTime(1, 1, 1, 6, 0, 0, 0);
    wt1.ToTime = new DateTime(1, 1, 1, 12, 0, 0, 0);
    WorkingTime wt2 = new WorkingTime();
    wt2.FromTime = new DateTime(1, 1, 1, 14, 0, 0, 0);
    wt2.ToTime = new DateTime(1, 1, 1, 18, 0, 0, 0);
    myWeekDay.WorkingTimes.Add(wt1);
    myWeekDay.WorkingTimes.Add(wt2);
    myWeekDay.DayWorking = true;
calendar.Days.Add(myWeekDay);
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Friday));
// adds weekend
calendar.Days.Add(new WeekDay(DayType.Saturday));
calendar.Days.Add(new WeekDay(DayType.Sunday));
[VB]
' create empty calendar
Dim calendar As Calendar =  New Calendar("New calendar")
' adds default working days (8 working hours from 9:00 to 17:00)
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Monday))
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Tuesday))
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Wednesday))
' create new new working day
Dim myWeekDay As WeekDay =  New WeekDay(DayType.Thursday)
' Sets working time. Only time part of DateTime is important
    Dim wt1 As WorkingTime =  New WorkingTime()
    wt1.FromTime = New DateTime(1, 1, 1, 6, 0, 0, 0)
    wt1.ToTime = New DateTime(1, 1, 1, 12, 0, 0, 0)
    Dim wt2 As WorkingTime =  New WorkingTime()
    wt2.FromTime = New DateTime(1, 1, 1, 14, 0, 0, 0)
    wt2.ToTime = New DateTime(1, 1, 1, 18, 0, 0, 0)
    myWeekDay.WorkingTimes.Add(wt1)
    myWeekDay.WorkingTimes.Add(wt2)
    myWeekDay.DayWorking = True
calendar.Days.Add(myWeekDay)
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Friday))
' adds weekend
calendar.Days.Add(New WeekDay(DayType.Saturday))
calendar.Days.Add(New WeekDay(DayType.Sunday))

Calendars are used to define standard working and non-working times. Projects must have one base calendar. Tasks and resources can have their own non-base calendars that are based on a base calendar.

Methods

NameDescription
DeleteRemoves calendar from project.
EqualsReturns a value indicating whether this instance is equal to a specified object.
get_BaseCalendarGets the base calendar on which this calendar depends. Only applicable if the calendar is not a base calendar.
get_ExceptionsGets CalendarExceptionCollection object. The collection of exceptions that is associated with the calendar.
get_GuidGets calendar’s Guid.
get_IsBaseCalendarGets a value indicating whether the calendar is a base calendar.
get_IsBaselineCalendarGets a value indicating whether the calendar is a baseline calendar.
get_NameGets the name of the calendar.
get_UidGets the unique identifier of the calendar.
get_WeekDaysGets WeekDaysCollection for this calendar. The collection of weekdays that defines the calendar.
get_WorkWeeksGets WorkWeekCollections object. The collection of work weeks that is associated with the calendar.
GetFinishDateByStartAndWork (2 overloads)Calculates the date when the specified amount of work time will pass according to the calendar.
GetHashCodeReturns a hash code for the instance of the class.
GetIntersectionCalendarGets ICalendar instance which can be used to perform calculations on the intersection of work schedules of 2 calendars.
GetNextWorkingDayStartCalculates next working day start for the specified date.
GetPreviousWorkingDayEndCalculates the end of the previous working date from the specified date.
GetStartDateFromFinishAndDuration (2 overloads)Returns start date based on the specified finish date and duration.
GetTaskFinishDateFromDurationCalculates the task finish date and time from its start date, split parts and the work duration.
GetWorkingHours (2 overloads)Returns the amount of working hours at the specified date.
GetWorkingHoursTimeSpanReturns amount of working hours between the specified dates.
GetWorkingTimesReturns WorkingTimeCollection of working times for the specified date.
GetWorkStartCalculates next working time start beginning from the specified date and time.
IsDayWorkingDetermines whether the specified day is a working day according to the calendar.
IsEmptyReturns whether the calendar doesn’t have working hours defined.
Make24HourCalendarMakes a given Calendar to be a 24Hour Calendar . 24Hours Calendar is a Calendar in which every day of week is working with Round-the-clock working hours.
MakeNightShiftCalendarMakes a given Calendar as Night Shift Calendar .
MakeStandardCalendarCreates default standard calendar.
set_BaseCalendarSets the base calendar on which this calendar depends. Only applicable if the calendar is not a base calendar.
set_IsBaselineCalendarSets a value indicating whether the calendar is a baseline calendar.
set_NameSets the name of the calendar.
set_UidSets the unique identifier of the calendar.