Class Calendar

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

Représente un calendrier utilisé dans un projet.

[ClassInterface(ClassInterfaceType.AutoDual)]
public class Calendar

Héritage

object ← Calendar

Membres hérités

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

Exemples

Comment créer un calendrier simple à partir de zéro.

// créer un calendrier vide
Calendar calendar = new Calendar("Nouveau calendrier");
// ajoute les jours de travail par défaut (8 heures de travail de 9h00 à 17h00)
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Monday));
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Tuesday));
calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Wednesday));
// créer un nouveau jour de travail
WeekDay myWeekDay = new WeekDay(DayType.Thursday);
// Définit le temps de travail. Seule la partie temps de DateTime est importante
    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));
// ajoute le week-end
calendar.Days.Add(new WeekDay(DayType.Saturday));
calendar.Days.Add(new WeekDay(DayType.Sunday));

csharp [VB] ’ créer un calendrier vide Dim calendar As Calendar = New Calendar(“Nouveau calendrier”) ’ ajoute les jours de travail par défaut (8 heures de travail de 9h00 à 17h00) calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Monday)) calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Tuesday)) calendar.Days.Add(WeekDay.CreateDefaultWorkingDay(DayType.Wednesday)) ’ créer un nouveau jour de travail Dim myWeekDay As WeekDay = New WeekDay(DayType.Thursday) ’ Définit le temps de travail. Seule la partie temps de DateTime est importante 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)) ’ ajoute le week-end calendar.Days.Add(New WeekDay(DayType.Saturday)) calendar.Days.Add(New WeekDay(DayType.Sunday))

## Remarques

Les calendriers sont utilisés pour définir les heures de travail et de non-travail standard.  
Les projets doivent avoir un calendrier de base. Les tâches et les ressources peuvent avoir  
leurs propres calendriers non de base qui sont basés sur un calendrier de base.

## Propriétés

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

Obtient ou définit le calendrier de base dont dépend ce calendrier.  
Applicable uniquement si le calendrier n'est pas un calendrier de base.

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

Valeur de la propriété

Calendar

Exceptions

Obtient l’objet CalendarExceptionCollection.
La collection d’exceptions qui est associée au calendrier.

public CalendarExceptionCollection Exceptions { get; }

Valeur de la propriété

CalendarExceptionCollection

Guid

Obtient le Guid du calendrier.

public string Guid { get; }

Valeur de la propriété

string

IsBaseCalendar

Obtient une valeur indiquant si le calendrier est un calendrier de base.

public bool IsBaseCalendar { get; }

Valeur de la propriété

bool

IsBaselineCalendar

Obtient ou définit une valeur indiquant si le calendrier est un calendrier de référence.

public bool IsBaselineCalendar { get; set; }

Valeur de la propriété

bool

Name

Obtient ou définit le nom du calendrier.

public string Name { get; set; }

Valeur de la propriété

string

Uid

Obtient ou définit l’identifiant unique du calendrier.

public int Uid { get; set; }

Valeur de la propriété

int

WeekDays

Obtient WeekDaysCollection pour ce calendrier.
La collection de jours de la semaine qui définit le calendrier.

public WeekDayCollection WeekDays { get; }

Valeur de la propriété

WeekDayCollection

WorkWeeks

Obtient l’objet WorkWeekCollections.
La collection de semaines de travail qui est associée au calendrier.

public WorkWeekCollection WorkWeeks { get; }

Valeur de la propriété

WorkWeekCollection

Méthodes

Delete()

Supprime le calendrier du projet.

public void Delete()

Equals(object)

Renvoie une valeur indiquant si cette instance est égale à un objet spécifié.

public override bool Equals(object obj)

Paramètres

obj object

L’objet à comparer avec cette instance.

Renvoie

bool

True si o est un Calendar ayant la même valeur Uid que cette instance ; sinon, false.

GetFinishDateByStartAndWork(DateTime, Duration)

Calcule la date à laquelle la quantité spécifiée de temps de travail sera écoulée selon le calendrier.

public DateTime GetFinishDateByStartAndWork(DateTime start, Duration work)

Paramètres

start DateTime

Date de début.

work Duration

Durée de travail.

Renvoie

DateTime

Date de fin.

GetFinishDateByStartAndWork(DateTime, TimeSpan)

Calcule la date à laquelle la quantité spécifiée de temps de travail sera écoulée selon le calendrier.

public DateTime GetFinishDateByStartAndWork(DateTime start, TimeSpan work)

Paramètres

start DateTime

Date de début.

work TimeSpan

Durée de travail.

Renvoie

DateTime

Date de fin.

GetHashCode()

Renvoie un code de hachage pour l’instance de la classe.

public override int GetHashCode()

Renvoie

int

un code de hachage pour cet objet.

GetNextWorkingDayStart(DateTime)

Calcule le début du prochain jour de travail à partir de la date.

public DateTime GetNextWorkingDayStart(DateTime date)

Paramètres

date DateTime

La date pour laquelle obtenir le début du prochain jour de travail.

Renvoie

DateTime

Début du prochain jour de travail System.DateTime.

GetPreviousWorkingDayEnd(DateTime)

Calcule la fin du jour de travail précédent à partir de la date spécifiée.

public DateTime GetPreviousWorkingDayEnd(DateTime date)

Paramètres

date DateTime

l’instance spécifiée de la structure System.DateTime.

Renvoie

DateTime

Fin du jour de travail précédent System.DateTime

GetStartDateFromFinishAndDuration(DateTime, Duration)

Renvoie la StartDate basée sur la FinishDate et la Duration spécifiées.

public DateTime GetStartDateFromFinishAndDuration(DateTime finish, Duration duration)

Paramètres

finish DateTime

La date de fin spécifiée.

duration Duration

La durée de travail spécifiée.

Renvoie

DateTime

StartDate calculée.

GetStartDateFromFinishAndDuration(DateTime, TimeSpan)

Renvoie la StartDate basée sur la FinishDate et la Duration spécifiées.

public DateTime GetStartDateFromFinishAndDuration(DateTime finish, TimeSpan duration)

Paramètres

finish DateTime

La date de fin spécifiée.

duration TimeSpan

La durée de travail spécifiée.

Renvoie

DateTime

StartDate calculée.

GetTaskFinishDateFromDuration(Task, TimeSpan)

Calcule la date et l’heure de fin de la tâche à partir de sa date de début, de ses parties divisées et de la durée.

public DateTime GetTaskFinishDateFromDuration(Task task, TimeSpan duration)

Paramètres

task Task

La tâche pour laquelle obtenir la date de fin.

duration TimeSpan

La durée de la tâche à diviser.

Renvoie

DateTime

Date de fin de la tâche.

Remarques

Renvoie DateTime.MinValue si la tâche est un résumé, nulle ou si sa date de début n’est pas définie.

GetWorkingHours(DateTime, DateTime)

Renvoie les heures de travail pour les dates spécifiées.

public WorkUnit GetWorkingHours(DateTime start, DateTime finish)

Paramètres

start DateTime

Date de début.

finish DateTime

Date de fin.

Renvoie

WorkUnit

Heures de travail.

GetWorkingHours(DateTime)

Renvoie le montant des heures de travail à la date.

public TimeSpan GetWorkingHours(DateTime dt)

Paramètres

dt DateTime

La date pour laquelle obtenir les heures de travail.

Renvoie

TimeSpan

Heures de travail.

GetWorkingTimes(DateTime)

Renvoie Aspose.Tasks.WorkingTimeCollection des temps de travail pour la date spécifiée.

public WorkingTimeCollection GetWorkingTimes(DateTime dt)

Paramètres

dt DateTime

La date pour laquelle obtenir les temps de travail.

Renvoie

WorkingTimeCollection

Liste de Aspose.Tasks.WorkingTime.

IsDayWorking(DateTime)

Détermine si le jour est un jour de travail.

public bool IsDayWorking(DateTime dt)

Paramètres

dt DateTime

La date pour laquelle vérifier si le jour est un jour de travail.

Renvoie

bool

Vrai si le jour est un jour de travail.

Make24HourCalendar(Calendar)

Transforme un calendrier donné en un calendrier de 24 heures.
Un calendrier de 24 heures est un calendrier dans lequel chaque jour de la semaine est un jour de travail avec des heures de travail continues.

public static Calendar Make24HourCalendar(Calendar calendar)

Paramètres

calendar Calendar

Calendrier à transformer en calendrier de 24 heures.

Renvoie

Calendar

Calendrier de 24 heures.

MakeNightShiftCalendar(Calendar)

Transforme un calendrier donné en un calendrier de nuit.

public static Calendar MakeNightShiftCalendar(Calendar calendar)

Paramètres

calendar Calendar

Calendrier à transformer en calendrier de nuit.

Renvoie

Calendar

Calendrier de nuit.

MakeStandardCalendar(Calendar)

Crée un calendrier standard par défaut.

public static Calendar MakeStandardCalendar(Calendar calendar)

Paramètres

calendar Calendar

Calendrier à partir duquel créer un calendrier standard.

Renvoie

Calendar

Calendrier avec 5 jours de travail (lundi-vendredi) avec des heures de travail de 8h à 12h et de 13h à 17h.