Class Calendar

Calendar class

Rappresenta un calendario utilizzato in un progetto.

public class Calendar

Proprietà

NomeDescrizione
BaseCalendar { get; set; }Ottiene o imposta il calendario di base da cui dipende questo calendario. Applicabile solo se il calendario non è un calendario di base.
Exceptions { get; }Ottiene l’oggetto CalendarExceptionCollection. La raccolta di eccezioni associata al calendario.
IsBaseCalendar { get; }Ottiene un valore che indica se il calendario è un calendario di base.
IsBaselineCalendar { get; set; }Ottiene o imposta un valore che indica se il calendario è un calendario di base.
Name { get; set; }Ottiene o imposta il nome del calendario.
Uid { get; set; }Ottiene o imposta l’identificatore univoco del calendario.
WeekDays { get; }Ottiene WeekDaysCollection per questo calendario. La raccolta di giorni della settimana che definisce il calendario.
WorkWeeks { get; }Ottiene l’oggetto WorkWeekCollections. La raccolta di settimane lavorative associata al calendario.

Metodi

NomeDescrizione
static Make24HourCalendar(Calendar)Rende un determinato calendario un calendario di 24 ore. Il calendario di 24 ore è un calendario in cui ogni giorno della settimana funziona con l’orario di lavoro 24 ore su 24.
static MakeNightShiftCalendar(Calendar)Crea un determinato calendario come calendario del turno di notte.
static MakeStandardCalendar(Calendar)Crea un calendario standard predefinito.
Delete()Rimuove il calendario dal progetto.
override Equals(object)Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.
GetFinishDateByStartAndWork(DateTime, Duration)Calcola la data in cui trascorrerà la quantità di tempo di lavoro specificata in base al calendario.
GetFinishDateByStartAndWork(DateTime, TimeSpan)Calcola la data in cui trascorrerà la quantità di tempo di lavoro specificata in base al calendario.
override GetHashCode()Restituisce un codice hash per l’istanza della classe.
GetNextWorkingDayStart(DateTime)Calcola il giorno lavorativo successivo a partire dalla data.
GetPreviousWorkingDayEnd(DateTime)Calcola la fine della data lavorativa precedente dalla data specificata.
GetStartDateFromFinishAndDuration(DateTime, Duration)Restituisce StartDate in base a FinishDate e Duration specificati.
GetStartDateFromFinishAndDuration(DateTime, TimeSpan)Restituisce StartDate in base a FinishDate e Duration specificati.
GetTaskFinishDateFromDuration(Task, TimeSpan)Calcola la data e l’ora di fine dell’attività dalla data di inizio, le parti divise e la durata.
GetWorkingHours(DateTime)Restituisce la quantità di ore lavorative alla data.
GetWorkingHours(DateTime, DateTime)Restituisce l’orario di lavoro per le date specificate.
GetWorkingTimes(DateTime)RitornaWorkingTimeCollection dell’orario di lavoro per la data specificata.
IsDayWorking(DateTime)Determina se il giorno è lavorativo.

Osservazioni

I calendari vengono utilizzati per definire orari lavorativi e non lavorativi standard. I progetti devono avere un calendario di base. Le attività e le risorse possono avere i propri calendari non di base basati su un calendario di base.

Esempi

Come creare un semplice calendario da zero.

[C#]
// crea un calendario vuoto
Calendar calendar = new Calendar("New calendar");
// aggiunge i giorni lavorativi predefiniti (8 ore lavorative dalle 9:00 alle 17:00)
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Monday));
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Tuesday));
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Wednesday));
// crea un nuovo nuovo giorno lavorativo
WeekDay myWeekDay = new WeekDay(DayType.Thursday);
// Imposta l'orario di lavoro. Solo la parte temporale di DateTime è importante
    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));
// aggiunge fine settimana
calendar.Days.Add(new WeekDay(DayType.Saturday));
calendar.Days.Add(new WeekDay(DayType.Sunday));

[VB]
' creare un calendario vuoto
Dim calendar As Calendar =  New Calendar("New calendar")
' aggiunge i giorni lavorativi predefiniti (8 ore lavorative dalle 9:00 alle 17:00)
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Monday))
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Tuesday))
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Wednesday))
' creare un nuovo nuovo giorno lavorativo
Dim myWeekDay As WeekDay =  New WeekDay(DayType.Thursday)
' Imposta l'orario di lavoro. Solo la parte temporale di DateTime è importante
    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))
' aggiunge fine settimana
calendar.Days.Add(New WeekDay(DayType.Saturday))
calendar.Days.Add(New WeekDay(DayType.Sunday))

Guarda anche

Enum CalculationType Class CalendarCollection