Class Calendar

Namespace: Aspose.Tasks
Assembly: Aspose.Tasks.dll (25.2.0)

Stellt einen Kalender dar, der in einem Projekt verwendet wird.

[ClassInterface(ClassInterfaceType.AutoDual)]
public class Calendar

Vererbung

object ← Calendar

Vererbte Mitglieder

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Beispiele

So erstellen Sie einen einfachen Kalender von Grund auf.

// leeren Kalender erstellen
Calendar calendar = new Calendar("Neuer Kalender");
// fügt Standardarbeitstage hinzu (8 Arbeitsstunden von 9:00 bis 17:00)
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Monday));
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Tuesday));
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Wednesday));
// neuen Arbeitstag erstellen
WeekDay myWeekDay = new WeekDay(DayType.Thursday);
// Arbeitszeit festlegen. Nur der Zeitanteil von DateTime ist wichtig
    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));
// Wochenende hinzufügen
calendar.Days.Add(new WeekDay(DayType.Saturday));
calendar.Days.Add(new WeekDay(DayType.Sunday));
```````csharp
[VB]
       ' leeren Kalender erstellen
       Dim calendar As Calendar =  New Calendar("Neuer Kalender")
       ' fügt Standardarbeitstage hinzu (8 Arbeitsstunden von 9:00 bis 17:00)
       calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Monday))
       calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Tuesday))
       calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Wednesday))
       ' neuen Arbeitstag erstellen
       Dim myWeekDay As WeekDay =  New WeekDay(DayType.Thursday)
       ' Arbeitszeit festlegen. Nur der Zeitanteil von DateTime ist wichtig
           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))
       ' Wochenende hinzufügen
       calendar.Days.Add(New WeekDay(DayType.Saturday))
       calendar.Days.Add(New WeekDay(DayType.Sunday))

Anmerkungen

Kalender werden verwendet, um Standardarbeits- und Nicht-Arbeitszeiten zu definieren.
Projekte müssen einen Basis-Kalender haben. Aufgaben und Ressourcen können
ihre eigenen Nicht-Basis-Kalender haben, die auf einem Basis-Kalender basieren.

Eigenschaften

BaseCalendar

Erhält oder setzt den Basis-Kalender, von dem dieser Kalender abhängt.
Nur anwendbar, wenn der Kalender kein Basis-Kalender ist.

public Calendar BaseCalendar { get; set; }

Eigenschaftswert

Calendar

Exceptions

Erhält das CalendarExceptionCollection-Objekt.
Die Sammlung von Ausnahmen, die mit dem Kalender verbunden sind.

public CalendarExceptionCollection Exceptions { get; }

Eigenschaftswert

CalendarExceptionCollection

Guid

Erhält die Guid des Kalenders.

public string Guid { get; }

Eigenschaftswert

string

IsBaseCalendar

Erhält einen Wert, der angibt, ob der Kalender ein Basis-Kalender ist.

public bool IsBaseCalendar { get; }

Eigenschaftswert

bool

IsBaselineCalendar

Erhält oder setzt einen Wert, der angibt, ob der Kalender ein Basislinien-Kalender ist.

public bool IsBaselineCalendar { get; set; }

Eigenschaftswert

bool

Name

Erhält oder setzt den Namen des Kalenders.

public string Name { get; set; }

Eigenschaftswert

string

Uid

Erhält oder setzt die eindeutige Kennung des Kalenders.

public int Uid { get; set; }

Eigenschaftswert

int

WeekDays

Erhält die WeekDaysCollection für diesen Kalender.
Die Sammlung von Wochentagen, die den Kalender definiert.

public WeekDayCollection WeekDays { get; }

Eigenschaftswert

WeekDayCollection

WorkWeeks

Erhält das WorkWeekCollections-Objekt.
Die Sammlung von Arbeitswochen, die mit dem Kalender verbunden sind.

public WorkWeekCollection WorkWeeks { get; }

Eigenschaftswert

WorkWeekCollection

Methoden

Delete()

Entfernt den Kalender aus dem Projekt.

public void Delete()

Equals(object)

Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem bestimmten Objekt ist.

public override bool Equals(object obj)

Parameter

obj object

Das Objekt, mit dem diese Instanz verglichen werden soll.

Rückgabewert

bool

True, wenn o ein Kalender ist, der den gleichen Uid-Wert wie diese Instanz hat; andernfalls false.

GetFinishDateByStartAndWork(DateTime, Duration)

Berechnet das Datum, an dem die angegebene Arbeitszeit gemäß dem Kalender verstrichen sein wird.

public DateTime GetFinishDateByStartAndWork(DateTime start, Duration work)

Parameter

start DateTime

Startdatum.

work Duration

Arbeitsdauer.

Rückgabewert

DateTime

Fertigstellungsdatum.

GetFinishDateByStartAndWork(DateTime, TimeSpan)

Berechnet das Datum, an dem die angegebene Arbeitszeit gemäß dem Kalender verstrichen sein wird.

public DateTime GetFinishDateByStartAndWork(DateTime start, TimeSpan work)

Parameter

start DateTime

Startdatum.

work TimeSpan

Arbeitsdauer.

Rückgabewert

DateTime

Fertigstellungsdatum.

GetHashCode()

Gibt einen Hashcode für die Instanz der Klasse zurück.

public override int GetHashCode()

Rückgabewert

int

Ein Hashcode für dieses Objekt.

GetNextWorkingDayStart(DateTime)

Berechnet den Beginn des nächsten Arbeitstags vom Datum.

public DateTime GetNextWorkingDayStart(DateTime date)

Parameter

date DateTime

Das Datum, für das der Beginn des nächsten Arbeitstags ermittelt werden soll.

Rückgabewert

DateTime

Beginn des nächsten Arbeitstags System.DateTime.

GetPreviousWorkingDayEnd(DateTime)

Berechnet das Ende des vorherigen Arbeitstags vom angegebenen Datum.

public DateTime GetPreviousWorkingDayEnd(DateTime date)

Parameter

date DateTime

Die angegebene Instanz der System.DateTime-Struktur.

Rückgabewert

DateTime

Ende des vorherigen Arbeitstags System.DateTime

GetStartDateFromFinishAndDuration(DateTime, Duration)

Gibt das Startdatum basierend auf dem angegebenen Fertigstellungsdatum und der Dauer zurück.

public DateTime GetStartDateFromFinishAndDuration(DateTime finish, Duration duration)

Parameter

finish DateTime

Das angegebene Fertigstellungsdatum.

duration Duration

Die angegebene Arbeitsdauer.

Rückgabewert

DateTime

Berechnetes Startdatum.

GetStartDateFromFinishAndDuration(DateTime, TimeSpan)

Gibt das Startdatum basierend auf dem angegebenen Fertigstellungsdatum und der Dauer zurück.

public DateTime GetStartDateFromFinishAndDuration(DateTime finish, TimeSpan duration)

Parameter

finish DateTime

Das angegebene Fertigstellungsdatum.

duration TimeSpan

Die angegebene Arbeitsdauer.

Rückgabewert

DateTime

Berechnetes Startdatum.

GetTaskFinishDateFromDuration(Task, TimeSpan)

Berechnet das Fertigstellungsdatum und die Uhrzeit der Aufgabe basierend auf ihrem Startdatum, den aufgeteilten Teilen und der Dauer.

public DateTime GetTaskFinishDateFromDuration(Task task, TimeSpan duration)

Parameter

task Task

Die Aufgabe, für die das Fertigstellungsdatum ermittelt werden soll.

duration TimeSpan

Die Arbeitsdauer der Aufgabe, die aufgeteilt werden soll.

Rückgabewert

DateTime

Fertigstellungsdatum der Aufgabe.

Anmerkungen

Gibt DateTime.MinValue zurück, wenn die Aufgabe eine Zusammenfassung ist, null ist oder ihr Startdatum nicht festgelegt ist.

GetWorkingHours(DateTime, DateTime)

Gibt die Arbeitsstunden für die angegebenen Daten zurück.

public WorkUnit GetWorkingHours(DateTime start, DateTime finish)

Parameter

start DateTime

Startdatum.

finish DateTime

Fertigstellungsdatum.

Rückgabewert

WorkUnit

Arbeitsstunden.

GetWorkingHours(DateTime)

Gibt die Anzahl der Arbeitsstunden am Datum zurück.

public TimeSpan GetWorkingHours(DateTime dt)

Parameter

dt DateTime

Das Datum, für das die Arbeitsstunden ermittelt werden sollen.

Rückgabewert

TimeSpan

Arbeitsstunden.

GetWorkingTimes(DateTime)

Gibt die Aspose.Tasks.WorkingTimeCollection der Arbeitszeiten für das angegebene Datum zurück.

public WorkingTimeCollection GetWorkingTimes(DateTime dt)

Parameter

dt DateTime

Das Datum, für das die Arbeitszeiten ermittelt werden sollen.

Rückgabewert

WorkingTimeCollection

Liste von Aspose.Tasks.WorkingTime.

IsDayWorking(DateTime)

Bestimmt, ob der Tag ein Arbeitstag ist.

public bool IsDayWorking(DateTime dt)

Parameter

dt DateTime

Das Datum, für das überprüft werden soll, ob es ein Arbeitstag ist.

Rückgabewert

bool

Wahr, wenn der Tag ein Arbeitstag ist.

Make24HourCalendar(Calendar)

Macht einen gegebenen Kalender zu einem 24-Stunden-Kalender.
Ein 24-Stunden-Kalender ist ein Kalender, in dem jeder Tag der Woche mit Rund-um-die-Uhr-Arbeitszeiten arbeitet.

public static Calendar Make24HourCalendar(Calendar calendar)

Parameter

calendar Calendar

Kalender, aus dem ein 24-Stunden-Kalender erstellt werden soll.

Rückgabewert

Calendar

24-Stunden-Kalender.

MakeNightShiftCalendar(Calendar)

Macht einen gegebenen Kalender zu einem Nachtschicht-Kalender.

public static Calendar MakeNightShiftCalendar(Calendar calendar)

Parameter

calendar Calendar

Kalender, aus dem ein Nachtschicht-Kalender erstellt werden soll.

Rückgabewert

Calendar

Nachtschicht-Kalender.

MakeStandardCalendar(Calendar)

Erstellt den Standardkalender.

public static Calendar MakeStandardCalendar(Calendar calendar)

Parameter

calendar Calendar

Kalender, aus dem der Standardkalender erstellt werden soll.

Rückgabewert

Calendar

Kalender mit 5 Arbeitstagen (Montag-Freitag) mit Arbeitszeiten von 8-12 und 13-17.