プロジェクトファイルからのカレンダー情報の読み取り

概要

Microsoft Projectでは、プロジェクトレベルの作業時間、タスク、およびリソースの可用性に対してさまざまなカレンダーを関連付けることができます。Aspose.Tasks for .NETは、主要なバージョン（2003-2013以降）を含むMPPファイルからのカレンダーデータの読み取りを完全にサポートしています。

この記事では、カレンダーコレクションの取得方法、詳細なカレンダー設定（作業週など）の読み取り、およびAspose.Tasks APIを使用して指定された日付間の実際の作業時間を計算する方法について説明します。

カレンダー情報の取得

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クラスを通じてこれらを公開します。

作業週は、CalendarオブジェクトのWorkWeeksプロパティを介してアクセスできます。各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;
    }
}

日付間の作業時間の計算

スケジューリングの実現可能性やリソースの可用性を評価するために、開発者は2つのDateTime値間の総作業時間を計算する必要がある場合があります。Aspose.Tasksは、Calendarクラスの2つのメソッドオーバーロードを通じてこれを可能にします：

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

注意: 日付範囲を指定する場合は、完全なタイムスタンプ（時、分、秒）を提供してください。endの日付が時刻なしで渡された場合（例：2025-08-18）、00:00:00として扱われ、間隔から除外されます。

以下の例では、2つの日付間の作業期間を分、時間、日で計算します。

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