タスク期間を扱う

タスクには時間がかかり、期間があります。現実的なタスクの期間は、現実的なプロジェクトの終了日を与えるのに役立ちます。 C ++ APIのAspose.Tasksを使用すると、開発者はプロジェクトでタスク期間を設定できます。

期間を扱う

TSKクラスによって公開される期間と期間のプロパティは、タスクの期間の計画された期間と形式を決定するために使用されます。

• 期間は設定され、タスクの計画期間(タイムスパン)を取得します。
• DuperationFormatは、TimeTiptype列挙で定義された形式を設定し、取得します。

Microsoftプロジェクトの期間

Microsoftプロジェクトでのタスクの期間を確認するには、**より多くのビューを選択できます。

Asopsion.tasksを使用してタスク期間を設定

以下に示すコードの例は、タスクの持続時間をそれぞれ1週間と半週間に増やす方法を示しています。

// Create a new project and add a new task
System::SharedPtr<Project> project = System::MakeObject<Project>();
System::SharedPtr<Task> task = project->get_RootTask()->get_Children()->Add(u"Task");
    
// Task duration in days (default time unit)
Duration duration = task->Get<Duration>(Tsk::Duration());
System::Console::WriteLine(u"Duration equals 1 day: {0}", System::ObjectExt::Box<bool>(System::ObjectExt::Equals(System::ObjectExt::ToString(duration), u"1 day")));
    
// Convert to hours time unit
duration = duration.Convert(Aspose::Tasks::TimeUnitType::Hour);
System::Console::WriteLine(u"Duration equals 8 hrs: {0}", System::ObjectExt::Box<bool>(System::ObjectExt::Equals(System::ObjectExt::ToString(duration), u"8 hrs")));
    
// Get wrapped TimeSpan instance
System::Console::WriteLine(u"Duration TimeSpan equals to TimeSpan of 8 hrs: {0}", System::ObjectExt::Box<bool>(System::ObjectExt::Equals(duration.get_TimeSpan(), System::TimeSpan::FromHours(8))));
    
// Increase task duration to 1 week and display if duration is updated successfully
task->Set<Duration>(Tsk::Duration(), project->GetDuration(1, Aspose::Tasks::TimeUnitType::Week));
System::Console::WriteLine(u"Duration equals 1 wk: {0}", System::ObjectExt::Box<bool>(System::ObjectExt::Equals(System::ObjectExt::ToString(task->Get<Duration>(Tsk::Duration())), u"1 wk")));
    
// Decrease task duration and display if duration is updated successfully
task->Set<Duration>(Tsk::Duration(), task->Get<Duration>(Tsk::Duration()).Subtract(0.5));
System::Console::WriteLine(u"Duration equals 0.5 wks: {0}", System::ObjectExt::Box<bool>(System::ObjectExt::Equals(System::ObjectExt::ToString(task->Get<Duration>(Tsk::Duration())), u"0.5 wks")));

Calculating Durations

It can be useful to calculate the duration of a task in different units such as minutes, hours, etc.

The Tsk class provides the Duration property for accessing task duration, which returns the Duration class object. The Convert method exposed as part of Duration class can then be used to calculate task durations in different units. This method takes TimeUnitType as the input argument and returns the duration as a double value.

The following code example demonstrates how to use this method to retrieve a task’s duration in different units: minute, day, hour, week and month.

// Create project instance
System::String dataDir = RunExamples::GetDataDir(System::Reflection::MethodBase::GetCurrentMethod(ASPOSE_CURRENT_FUNCTION)->get_DeclaringType().get_FullName());
System::SharedPtr<Project> project1 = System::MakeObject<Project>(dataDir + u"TaskDurations.mpp");
    
// Get a task to calculate its duration in different formats
System::SharedPtr<Task> task = project1->get_RootTask()->get_Children()->GetById(1);
    
// Get the duration in Minutes, Days, Hours, Weeks and Months
double mins = task->Get<Duration>(Tsk::Duration()).Convert(Aspose::Tasks::TimeUnitType::Minute).ToDouble();
System::Console::WriteLine(u"Duration in Mins: {0}", System::ObjectExt::Box<double>(mins));
double days = task->Get<Duration>(Tsk::Duration()).Convert(Aspose::Tasks::TimeUnitType::Day).ToDouble();
System::Console::WriteLine(u"Duration in Days: {0}", System::ObjectExt::Box<double>(days));
double hours = task->Get<Duration>(Tsk::Duration()).Convert(Aspose::Tasks::TimeUnitType::Hour).ToDouble();
System::Console::WriteLine(u"Duration in Hours: {0}", System::ObjectExt::Box<double>(hours));
double weeks = task->Get<Duration>(Tsk::Duration()).Convert(Aspose::Tasks::TimeUnitType::Week).ToDouble();
System::Console::WriteLine(u"Duration in Weeks: {0}", System::ObjectExt::Box<double>(weeks));
double months = task->Get<Duration>(Tsk::Duration()).Convert(Aspose::Tasks::TimeUnitType::Month).ToDouble();
System::Console::WriteLine(u"Duration in Months: {0}", System::ObjectExt::Box<double>(months));