Lectura de Información del Calendario desde Archivos de Proyecto

Resumen

Microsoft Project permite asociar varios calendarios con el tiempo de trabajo a nivel de proyecto, tareas y disponibilidad de recursos. Aspose.Tasks for .NET ofrece soporte completo para la lectura de estos datos de calendario desde archivos MPP, incluyendo todas las versiones principales (2003–2013 y posteriores).

Este artículo explica cómo recuperar colecciones de calendarios, leer configuraciones detalladas del calendario (por ejemplo, semanas laborales) y calcular las horas laborales reales entre fechas específicas utilizando la API de Aspose.Tasks.

Recuperación de Información del Calendario

La clase Project expone la propiedad Calendars, que devuelve una CalendarCollection. Esta colección contiene todos los calendarios definidos en el archivo de proyecto.

Para verificar los calendarios en Microsoft Project:

1. Abre el archivo de proyecto.
2. Navega a Proyecto > Cambiar horario laboral.

El siguiente código demuestra cómo iterar sobre los calendarios del proyecto y recuperar sus metadatos.

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

Lectura de Configuraciones de Semanas Laborales

Los calendarios en Microsoft Project pueden definir semanas laborales personalizadas para sobrescribir los horarios de trabajo predeterminados. Aspose.Tasks expone estas semanas mediante la clase WorkWeek.

Las semanas laborales se pueden acceder a través de la propiedad WorkWeeks del objeto Calendar. Cada WorkWeek contiene metadatos sobre el rango de fechas y los horarios laborales para cada día.

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

Cálculo de Horas Laborales Entre Fechas

Para evaluar la viabilidad de la programación o la disponibilidad de recursos, los desarrolladores pueden necesitar calcular el número total de horas laborales entre dos valores DateTime. Aspose.Tasks permite esto mediante dos sobrecargas del método en la clase Calendar:

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

Nota: Al especificar rangos de fechas, proporciona marcas de tiempo completas (hora, minuto, segundo). Si la fecha end se pasa sin hora (por ejemplo, 2025-08-18), se trata como 00:00:00 y se excluye del intervalo.

El siguiente ejemplo calcula las duraciones laborales en minutos, horas y días entre dos fechas.

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