Читання інформації календаря з файлів проекту

Огляд

Microsoft Project дозволяє пов’язувати різні календарі з робочим часом на рівні проекту, завданнями та доступністю ресурсів. Aspose.Tasks для .NET забезпечує повну підтримку читання цих даних календаря з файлів MPP, включаючи всі основні версії (2003–2013 та пізніші).

Ця стаття пояснює, як отримувати колекції календарів, читати детальну конфігурацію календаря (наприклад, робочі тижні) та обчислювати фактичні робочі години між зазначеними датами за допомогою API Aspose.Tasks.

Отримання інформації календаря

Клас Project надає властивість Calendars, яка повертає CalendarCollection. Ця колекція містить всі календарі, визначені у файлі проекту.

Щоб перевірити календарі в Microsoft Project:

1. Відкрийте файл проекту.
2. Перейдіть до Проект > Змінити робочий час.

Наступний код демонструє, як ітерувати календарі проекту та отримувати їх метадані.

// 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());
            }
        }
    }
}

Читання конфігурацій робочих тижнів

Календарі в Microsoft Project можуть визначати користувацькі робочі тижні для перевизначення стандартного робочого часу. Aspose.Tasks надає доступ до них через клас WorkWeek.

Робочі тижні можна отримати через властивість WorkWeeks об’єкта Calendar. Кожен WorkWeek містить метадані про діапазон дат та робочий час для кожного дня.

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;
    }
}

Обчислення робочих годин між датами

Для оцінки можливості планування або доступності ресурсів розробникам може знадобитися обчислити загальну кількість робочих годин між двома значеннями DateTime. Aspose.Tasks забезпечує це через два перевантаження методів класу Calendar:

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

Примітка: При вказівці діапазонів дат надавайте повні позначки часу (година, хвилина, секунда). Якщо дата end передається без часу (наприклад, 2025-08-18), вона розглядається як 00:00:00 і виключається з інтервалу.

Наступний приклад обчислює тривалість роботи в хвилинах, годинах та днях між двома датами.

// 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);