Kalenderinformationen aus Projektdateien lesen

Überblick

Microsoft Project ermöglicht die Zuordnung verschiedener Kalender zu projektbezogenen Arbeitszeiten, Aufgaben und Ressourcenverfügbarkeit. Aspose.Tasks for .NET bietet vollständige Unterstützung für das Auslesen dieser Kalenderdaten aus MPP-Dateien, einschließlich aller Hauptversionen (2003–2013 und neuer).

Dieser Artikel erklärt, wie man Kalenderlisten abruft, detaillierte Kalendereinstellungen (z. B. Arbeitswochen) ausliest und tatsächliche Arbeitszeiten zwischen bestimmten Datumsbereichen berechnet – mithilfe der Aspose.Tasks API.

Abrufen von Kalenderinformationen

Die Klasse Project stellt die Eigenschaft Calendars bereit, die eine CalendarCollection zurückgibt. Diese Sammlung enthält alle im Projekt definierten Kalender.

So überprüfen Sie Kalender in Microsoft Project:

1. Öffnen Sie die Projektdatei.
2. Navigieren Sie zu Projekt > Arbeitszeit ändern.

Der folgende Beispielcode zeigt, wie Sie über Projektkalender iterieren und deren Metadaten abrufen können.

// Create a project instance
Project project = new Project("RetrieveCalendarInfo.mpp");

// Retrieve Calendars Information
CalendarCollection calendars = project.Calendars;
foreach (Calendar cal in calendars)
{
    if (cal.Name != null)
    {
        Console.WriteLine("Calendar UID : " + cal.Uid);
        Console.WriteLine("Calendar Name : " + cal.Name);

        WeekDayCollection alDays = cal.WeekDays;
        foreach (WeekDay wd in alDays)
        {
            TimeSpan ts = wd.GetWorkingTime();
            if (wd.DayWorking)
            {
                Console.WriteLine(wd.DayType.ToString() + ":");
                Console.WriteLine(ts.ToString());
            }
        }
    }
}

Auslesen von Arbeitswochenkonfigurationen

Kalender in Microsoft Project können benutzerdefinierte Arbeitswochen definieren, die Standardarbeitszeiten überschreiben. Aspose.Tasks stellt dafür die Klasse WorkWeek bereit.

Auf Arbeitswochen kann über die Eigenschaft WorkWeeks des Calendar-Objekts zugegriffen werden. Jede WorkWeek enthält Metadaten zum Datumsbereich und zu den Arbeitszeiten pro Wochentag.

Project project = new Project("ReadWorkWeeksInformation.mpp");
Calendar calendar = project.Calendars.GetByUid(3);
WorkWeekCollection collection = calendar.WorkWeeks;

foreach (WorkWeek workWeek in collection)
{
    DateTime fromDate = workWeek.FromDate;
    DateTime toDate = workWeek.ToDate;

    // This data is all about "Details." button you can set special working times for special WeekDay or even make it nonworking
    WeekDayCollection weekDays = workWeek.WeekDays;  
    foreach (WeekDay day in weekDays) 
    {
        // You can further traverse through working times and display these
        WorkingTimeCollection workingTimes = day.WorkingTimes;
    }
}

Berechnung von Arbeitsstunden zwischen zwei Daten

Zur Bewertung der Planung oder Verfügbarkeit von Ressourcen kann es notwendig sein, die Gesamtanzahl an Arbeitsstunden zwischen zwei DateTime-Werten zu berechnen. Aspose.Tasks ermöglicht dies über zwei Überladungen der Methode GetWorkingHours der Klasse Calendar:

• GetWorkingHours(DateTime dt)
• GetWorkingHours(DateTime start, DateTime end)

Hinweis: Bei Datumsbereichen sollten vollständige Zeitstempel (Stunde, Minute, Sekunde) angegeben werden. Wird das end-Datum ohne Uhrzeit übergeben (z. B. 2025-08-18), wird es als 00:00:00 interpretiert und vom Intervall ausgeschlossen.

Das folgende Beispiel berechnet die Arbeitsdauer in Minuten, Stunden und Tagen zwischen zwei Zeitpunkten.

// Load an existing project
Project project = new Project("New Project.mpp");

// Access Task By Id
Task task = project.RootTask.Children.GetById(1);

// Access Calendar and it's start and end dates
Calendar taskCalendar = task.Get(Tsk.Calendar);
DateTime startDate = task.Get(Tsk.Start);
DateTime endDate = task.Get(Tsk.Finish);
DateTime tempDate = startDate;

// Access resource and their calendar
Resource resource = project.Resources.GetByUid(1);
Calendar resourceCalendar = resource.Get(Rsc.Calendar);

TimeSpan timeSpan;

// Get Duration in Minutes
double durationInMins = 0;
while (tempDate < endDate)
{
    if (taskCalendar.IsDayWorking(tempDate) && resourceCalendar.IsDayWorking(tempDate))
    {
        timeSpan = taskCalendar.GetWorkingHours(tempDate);
        durationInMins = durationInMins + timeSpan.TotalMinutes;
    }
    tempDate = tempDate.AddDays(1);
}
tempDate = startDate;

// Get Duration in Hours
double durationInHours = 0;
while (tempDate < endDate)
{
    if (taskCalendar.IsDayWorking(tempDate) && resourceCalendar.IsDayWorking(tempDate))
    {
        timeSpan = taskCalendar.GetWorkingHours(tempDate);
        durationInHours = durationInHours + timeSpan.TotalHours;
    }
    tempDate = tempDate.AddDays(1);
}
tempDate = startDate;

// Get Duration in Days
double durationInDays = 0;
while (tempDate < endDate)
{
    if (taskCalendar.IsDayWorking(tempDate) && resourceCalendar.IsDayWorking(tempDate))
    {
        timeSpan = taskCalendar.GetWorkingHours(tempDate);
        if (timeSpan.TotalHours > 0)
        {
            durationInDays = durationInDays + timeSpan.TotalDays * (24 / (timeSpan.TotalHours));
        }
    }
    tempDate = tempDate.AddDays(1);
}

Console.WriteLine("Duration in Minutes = " + durationInMins);
Console.WriteLine("Duration in Hours = " + durationInHours);
Console.WriteLine("Duration in Days = " + durationInDays);