Class Calendar
Nom dels espais: Aspose.Tasks Assemblea: Aspose.Tasks.dll (25.4.0)
Representa un calendari utilitzat en un projecte.
[ClassInterface(ClassInterfaceType.AutoDual)]
public class Calendar : ICalendarInheritance
Implements
Membres heretats
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Examples
Com crear un calendari senzill des de l’escratx.
// 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))Remarks
Els calendaris s’utilitzen per definir els temps de treball estàndard i no de treball.Els projectes han de tenir un calendari de base. tasques i recursos poden tenirEls seus propis calendaris no bàsics que es basen en un calendari bàsic.
Properties
BaseCalendar
Obté o col·loca el calendari de base en què depèn aquest calendari.Només s’aplica si el calendari no és un calendari bàsic.
public Calendar BaseCalendar { get; set; }Valor de la propietat
Exceptions
Objecte de col·lecció Excepció de calendari.La col·lecció d’excepcions que està associada amb el calendari.
public CalendarExceptionCollection Exceptions { get; }Valor de la propietat
Guid
Guia del calendari.
public string Guid { get; }Valor de la propietat
IsBaseCalendar
Obté un valor que indica si el calendari és un calendari bàsic.
public bool IsBaseCalendar { get; }Valor de la propietat
IsBaselineCalendar
Obté o fixa un valor que indiqui si el calendari és un calendari de base.
public bool IsBaselineCalendar { get; set; }Valor de la propietat
Name
Obtenir o posar el nom del calendari.
public string Name { get; set; }Valor de la propietat
Uid
Obté o posa l’identificador únic del calendari.
public int Uid { get; set; }Valor de la propietat
WeekDays
Gets WeekDaysCol·lecció per a aquest calendari.Col·lecció de setmanes que defineixen el calendari.
public WeekDayCollection WeekDays { get; }Valor de la propietat
WorkWeeks
Objecte de col·leccions WorkWeek.La col·lecció de setmanes de treball que està associada amb el calendari.
public WorkWeekCollection WorkWeeks { get; }Valor de la propietat
Methods
Delete()
Elimina el calendari del projecte.
public void Delete()Equals(Objecte)
Retorna un valor que indica si aquesta instància és igual a un objecte especificat.
public override bool Equals(object obj)Parameters
obj object
L’objecte de comparar amb aquesta instància.
Returns
True si o és un calendari que té el mateix valor Uid que aquesta instància; en cas contrari, falsa.
GetFinishDateByStartAndWork(El temps, la durada)
Calcula la data en què passarà la quantitat de temps de treball especificada segons el calendari.
public DateTime GetFinishDateByStartAndWork(DateTime start, Duration work)Parameters
start DateTime
Data de començament.
work Duration
Durada de treball.
Returns
Finalitza la data.
GetFinishDateByStartAndWork(El temps, el temps)
Calcula la data en què passarà la quantitat de temps de treball especificada segons el calendari.
public DateTime GetFinishDateByStartAndWork(DateTime start, TimeSpan work)Parameters
start DateTime
Data de començament.
work TimeSpan
Durada de treball.
Returns
Finalitza la data.
GetHashCode()
Retorna un codi hash per a l’exemple de la classe.
public override int GetHashCode()Returns
Un codi hash per a aquest objecte.
GetIntersectionCalendar(Calendari i calendari)
Obté Aspose.Tasks.Instància de calendari que es pot utilitzar per realitzar càlculs a la intersecció dels horaris de treball de 2 calendaris.
public static ICalendar GetIntersectionCalendar(Calendar calendar1, Calendar calendar2)Parameters
calendar1 Calendar
El primer calendari.
calendar2 Calendar
segon calendari.
Returns
Implementació de la interfície ICalendar.
Exceptions
Quan qualsevol dels arguments és nul.
GetNextWorkingDayStart(DateTime)
Calcula el següent dia de treball que comença per a la data especificada.
public DateTime GetNextWorkingDayStart(DateTime date)Parameters
date DateTime
La data per obtenir el següent dia de treball comença per.
Returns
El següent dia de treball comença System.DateTime.
GetPreviousWorkingDayEnd(DateTime)
Calcula el final de la data de treball anterior des de l’especificada.
public DateTime GetPreviousWorkingDayEnd(DateTime date)Parameters
date DateTime
La data per calcular el final del dia de treball anterior.
Returns
El final de la jornada laboral anterior
GetStartDateFromFinishAndDuration(El temps, la durada)
Retorna la data d’inici basada en l’especificada data i durada de finalització.
public DateTime GetStartDateFromFinishAndDuration(DateTime finish, Duration duration)Parameters
finish DateTime
Data de finalització especificada.
duration Duration
La durada especificada.
Returns
Data d’inici calculada.
GetStartDateFromFinishAndDuration(El temps, el temps)
Retornes data d’inici basada en la data de finalització especificada i la durada.
public DateTime GetStartDateFromFinishAndDuration(DateTime finish, TimeSpan duration)Parameters
finish DateTime
Data de finalització especificada.
duration TimeSpan
La durada especificada.
Returns
Data d’inici calculada.
GetTaskFinishDateFromDuration(Tàrrega, TimeSpan)
Calcula la data i l’hora de finalitzar la tasca des de la seva data d’inici, les parts dividides i la durada del treball.
public DateTime GetTaskFinishDateFromDuration(Task task, TimeSpan duration)Parameters
task Task
La tasca per calcular la data de finalització.
duration TimeSpan
La durada per calcular.
Returns
Data de finalització de la tasca per a la data d’inici i durada donada.
Remarks
Retorna DateTime.MinValue si la tasca és resumida, nul·la o no s’estableix la data d’inici.
GetWorkingHours(El temps, el temps)
Retorn WorkUnit - Inici, finalització i durada de les hores de treball per a l’interval horari de la data especificada.
public WorkUnit GetWorkingHours(DateTime start, DateTime finish)Parameters
start DateTime
Data d’inici de l’interval.
finish DateTime
Finalitza la data de l’interval.
Returns
Instància de Aspose.Tasks.WorkUnit classe que conté Inici, Finalització i Durada de les hores de treball.
GetWorkingHours(DateTime)
Retorna la quantitat d’hores de treball a la data especificada.
public TimeSpan GetWorkingHours(DateTime dt)Parameters
dt DateTime
La data per obtenir hores de treball.
Returns
hores de treball a la data especificada.
GetWorkingTimes(DateTime)
Retorn Aspose.Tasks.WorkingTimeCol·lecció d’hores de treball per a la data especificada.
public WorkingTimeCollection GetWorkingTimes(DateTime dt)Parameters
dt DateTime
La data per obtenir hores de treball.
Returns
Col·lecció de Aspose.Tasks.WorkingTime instàncies.
IsDayWorking(DateTime)
Determina si el dia especificat és un dia de treball segons el calendari.
public bool IsDayWorking(DateTime dt)Parameters
dt DateTime
Data per comprovar si el dia està funcionant.
Returns
És veritat si el dia és un dia de treball.
Make24HourCalendar(Calendar)
El calendari és un calendari de 24 hores.El calendari 24 hores és un calendari en el qual cada dia de la setmana es treballa amb hores de treball rodona.
public static Calendar Make24HourCalendar(Calendar calendar)Parameters
calendar Calendar
Calendari per fer un calendari de 24 hores.
Returns
Calendari de 24 hores.
MakeNightShiftCalendar(Calendar)
Crea un calendari donat com a calendari de canvi de nit.
public static Calendar MakeNightShiftCalendar(Calendar calendar)Parameters
calendar Calendar
Calendari per fer el calendari de canvi de nit.
Returns
Calendari de canvi de nit.
MakeStandardCalendar(Calendar)
Crea un calendari estàndard.
public static Calendar MakeStandardCalendar(Calendar calendar)Parameters
calendar Calendar
Calendari per fer un calendari estàndard.
Returns
Calendari amb 5 dies laborals (Mondes-Dijous) amb horaris laborals 8-12 i 13-17.
