Class Calendar

Namespace: Aspose.Tasks
Assembly: Aspose.Tasks.dll (25.2.0)

Reprezentuje kalendarz używany w projekcie.

[ClassInterface(ClassInterfaceType.AutoDual)]
public class Calendar

Dziedziczenie

object ← Calendar

Dziedziczone członkowie

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Przykłady

Jak stworzyć prosty kalendarz od podstaw.

// utwórz pusty kalendarz
Calendar calendar = new Calendar("Nowy kalendarz");
// dodaje domyślne dni robocze (8 godzin roboczych od 9:00 do 17:00)
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Monday));
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Tuesday));
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Wednesday));
// utwórz nowy dzień roboczy
WeekDay myWeekDay = new WeekDay(DayType.Thursday);
// Ustawia czas pracy. Tylko część czasowa DateTime jest ważna
    WorkingTime wt1 = new WorkingTime();
    wt1.FromTime = new DateTime(1, 1, 1, 6, 0, 0, 0);
    wt1.ToTime = new DateTime(1, 1, 1, 12, 0, 0, 0);
    WorkingTime wt2 = new WorkingTime();
    wt2.FromTime = new DateTime(1, 1, 1, 14, 0, 0, 0);
    wt2.ToTime = new DateTime(1, 1, 1, 18, 0, 0, 0);
    myWeekDay.WorkingTimes.Add(wt1);
    myWeekDay.WorkingTimes.Add(wt2);
    myWeekDay.DayWorking = true;
calendar.Days.Add(myWeekDay);
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Friday));
// dodaje weekend
calendar.Days.Add(new WeekDay(DayType.Saturday));
calendar.Days.Add(new WeekDay(DayType.Sunday));

csharp [VB] ’ utwórz pusty kalendarz Dim calendar As Calendar = New Calendar(“Nowy kalendarz”) ’ dodaje domyślne dni robocze (8 godzin roboczych od 9:00 do 17:00) calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Monday)) calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Tuesday)) calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Wednesday)) ’ utwórz nowy dzień roboczy Dim myWeekDay As WeekDay = New WeekDay(DayType.Thursday) ’ Ustawia czas pracy. Tylko część czasowa DateTime jest ważna Dim wt1 As WorkingTime = New WorkingTime() wt1.FromTime = New DateTime(1, 1, 1, 6, 0, 0, 0) wt1.ToTime = New DateTime(1, 1, 1, 12, 0, 0, 0) Dim wt2 As WorkingTime = New WorkingTime() wt2.FromTime = New DateTime(1, 1, 1, 14, 0, 0, 0) wt2.ToTime = New DateTime(1, 1, 1, 18, 0, 0, 0) myWeekDay.WorkingTimes.Add(wt1) myWeekDay.WorkingTimes.Add(wt2) myWeekDay.DayWorking = True calendar.Days.Add(myWeekDay) calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Friday)) ’ dodaje weekend calendar.Days.Add(New WeekDay(DayType.Saturday)) calendar.Days.Add(New WeekDay(DayType.Sunday))

## Uwagi

Kalendarze są używane do definiowania standardowych czasów roboczych i wolnych. Projekty muszą mieć jeden podstawowy kalendarz. Zadania i zasoby mogą mieć własne kalendarze niepodstawowe, które opierają się na kalendarzu podstawowym.

## Właściwości

### <a id="Aspose_Tasks_Calendar_BaseCalendar"></a> BaseCalendar

Pobiera lub ustawia kalendarz podstawowy, na którym ten kalendarz się opiera. Dotyczy tylko, jeśli kalendarz nie jest kalendarzem podstawowym.

```csharp
public Calendar BaseCalendar { get; set; }

Wartość właściwości

Calendar

Exceptions

Pobiera obiekt CalendarExceptionCollection. Kolekcja wyjątków związanych z kalendarzem.

public CalendarExceptionCollection Exceptions { get; }

Wartość właściwości

CalendarExceptionCollection

Guid

Pobiera identyfikator Guid kalendarza.

public string Guid { get; }

Wartość właściwości

string

IsBaseCalendar

Pobiera wartość wskazującą, czy kalendarz jest kalendarzem podstawowym.

public bool IsBaseCalendar { get; }

Wartość właściwości

bool

IsBaselineCalendar

Pobiera lub ustawia wartość wskazującą, czy kalendarz jest kalendarzem bazowym.

public bool IsBaselineCalendar { get; set; }

Wartość właściwości

bool

Name

Pobiera lub ustawia nazwę kalendarza.

public string Name { get; set; }

Wartość właściwości

string

Uid

Pobiera lub ustawia unikalny identyfikator kalendarza.

public int Uid { get; set; }

Wartość właściwości

int

WeekDays

Pobiera WeekDaysCollection dla tego kalendarza. Kolekcja dni tygodnia definiująca kalendarz.

public WeekDayCollection WeekDays { get; }

Wartość właściwości

WeekDayCollection

WorkWeeks

Pobiera obiekt WorkWeekCollections. Kolekcja tygodni roboczych związanych z kalendarzem.

public WorkWeekCollection WorkWeeks { get; }

Wartość właściwości

WorkWeekCollection

Metody

Delete()

Usuwa kalendarz z projektu.

public void Delete()

Equals(object)

Zwraca wartość wskazującą, czy ta instancja jest równa określonemu obiektowi.

public override bool Equals(object obj)

Parametry

obj object

Obiekt do porównania z tą instancją.

Zwraca

bool

Prawda, jeśli o jest kalendarzem, który ma tę samą wartość Uid co ta instancja; w przeciwnym razie fałsz.

GetFinishDateByStartAndWork(DateTime, Duration)

Oblicza datę, kiedy określona ilość czasu pracy minie zgodnie z kalendarzem.

public DateTime GetFinishDateByStartAndWork(DateTime start, Duration work)

Parametry

start DateTime

Data początkowa.

work Duration

Czas pracy.

Zwraca

DateTime

Data zakończenia.

GetFinishDateByStartAndWork(DateTime, TimeSpan)

Oblicza datę, kiedy określona ilość czasu pracy minie zgodnie z kalendarzem.

public DateTime GetFinishDateByStartAndWork(DateTime start, TimeSpan work)

Parametry

start DateTime

Data początkowa.

work TimeSpan

Czas pracy.

Zwraca

DateTime

Data zakończenia.

GetHashCode()

Zwraca kod haszujący dla instancji klasy.

public override int GetHashCode()

Zwraca

int

kod haszujący dla tego obiektu.

GetNextWorkingDayStart(DateTime)

Oblicza początek następnego dnia roboczego od daty.

public DateTime GetNextWorkingDayStart(DateTime date)

Parametry

date DateTime

Data, dla której ma być obliczony początek następnego dnia roboczego.

Zwraca

DateTime

Początek następnego dnia roboczego System.DateTime.

GetPreviousWorkingDayEnd(DateTime)

Oblicza koniec poprzedniego dnia roboczego od podanej daty.

public DateTime GetPreviousWorkingDayEnd(DateTime date)

Parametry

date DateTime

podana instancja struktury System.DateTime.

Zwraca

DateTime

Koniec poprzedniego dnia roboczego System.DateTime

GetStartDateFromFinishAndDuration(DateTime, Duration)

Zwraca StartDate na podstawie podanego FinishDate i Duration.

public DateTime GetStartDateFromFinishAndDuration(DateTime finish, Duration duration)

Parametry

finish DateTime

Podana data zakończenia.

duration Duration

Podany czas pracy.

Zwraca

DateTime

Obliczona StartDate.

GetStartDateFromFinishAndDuration(DateTime, TimeSpan)

Zwraca StartDate na podstawie podanego FinishDate i Duration.

public DateTime GetStartDateFromFinishAndDuration(DateTime finish, TimeSpan duration)

Parametry

finish DateTime

Podana data zakończenia.

duration TimeSpan

Podany czas pracy.

Zwraca

DateTime

Obliczona StartDate.

GetTaskFinishDateFromDuration(Task, TimeSpan)

Oblicza datę i godzinę zakończenia zadania na podstawie jego daty rozpoczęcia, podzielonych części i czasu trwania.

public DateTime GetTaskFinishDateFromDuration(Task task, TimeSpan duration)

Parametry

task Task

Zadanie, dla którego ma być obliczona data zakończenia.

duration TimeSpan

Czas trwania zadania do podziału.

Zwraca

DateTime

Data zakończenia zadania.

Uwagi

Zwraca DateTime.MinValue, jeśli zadanie jest podsumowaniem, null lub jego data rozpoczęcia nie jest ustawiona.

GetWorkingHours(DateTime, DateTime)

Zwraca godziny pracy dla określonych dat.

public WorkUnit GetWorkingHours(DateTime start, DateTime finish)

Parametry

start DateTime

Data początkowa.

finish DateTime

Data zakończenia.

Zwraca

WorkUnit

Godziny pracy.

GetWorkingHours(DateTime)

Zwraca ilość godzin pracy w danym dniu.

public TimeSpan GetWorkingHours(DateTime dt)

Parametry

dt DateTime

Data, dla której ma być obliczona ilość godzin pracy.

Zwraca

TimeSpan

Godziny pracy.

GetWorkingTimes(DateTime)

Zwraca Aspose.Tasks.WorkingTimeCollection godzin pracy dla podanej daty.

public WorkingTimeCollection GetWorkingTimes(DateTime dt)

Parametry

dt DateTime

Data, dla której mają być zwrócone godziny pracy.

Zwraca

WorkingTimeCollection

Lista Aspose.Tasks.WorkingTime.

IsDayWorking(DateTime)

Określa, czy dany dzień jest dniem roboczym.

public bool IsDayWorking(DateTime dt)

Parametry

dt DateTime

Data, dla której ma być sprawdzone, czy dzień jest roboczy.

Zwraca

bool

Prawda, jeśli dzień jest dniem roboczym.

Make24HourCalendar(Calendar)

Ustawia dany kalendarz jako kalendarz 24-godzinny. Kalendarz 24-godzinny to kalendarz, w którym każdy dzień tygodnia jest dniem roboczym z całodobowymi godzinami pracy.

public static Calendar Make24HourCalendar(Calendar calendar)

Parametry

calendar Calendar

Kalendarz, z którego ma być utworzony kalendarz 24-godzinny.

Zwraca

Calendar

Kalendarz 24-godzinny.

MakeNightShiftCalendar(Calendar)

Ustawia dany kalendarz jako kalendarz nocny.

public static Calendar MakeNightShiftCalendar(Calendar calendar)

Parametry

calendar Calendar

Kalendarz, z którego ma być utworzony kalendarz nocny.

Zwraca

Calendar

Kalendarz nocny.

MakeStandardCalendar(Calendar)

Tworzy domyślny standardowy kalendarz.

public static Calendar MakeStandardCalendar(Calendar calendar)

Parametry

calendar Calendar

Kalendarz, z którego ma być utworzony standardowy kalendarz.

Zwraca

Calendar

Kalendarz z 5 dniami roboczymi (poniedziałek-piątek) z godzinami pracy 8-12 i 13-17.