DurationCalculator : global

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 8 minutes de lecture

    • L’include de script DurationCalculator fournit des méthodes de calcul des durées et des dates d’échéance.

    DurationCalculator : DurationCalculator( )

    Constructeur de la classe DurationCalculator .

    Tableau 1. Paramètres
    Nom Type Description
    Néant 
    var dc = new DurationCalculator();

    DurationCalculator : calcDuration(Nombre de secondes)

    Calcule une date et une heure de fin basées sur la date et l’heure de début actuelles et transmises (en secondes).

    Cette méthode définit également les this.endDateTimepropriétés , this.secondset avec this.totalSeconds les valeurs mises à jour. La seconds propriété représente le nombre total de secondes de travail à effectuer dans la durée basée sur le calendrier de travail. La totalSeconds propriété représente le nombre total de secondes entre les heures de début et de fin de la durée, qui inclut à la fois le travail et le non-travail.

    Avant d’appeler cette méthode, vous devez appeler setStartDateTime() avec l’heure de début à utiliser pour la durée.

    Tableau 2. Paramètres
    Nom Type Description
    secondes Numéro Nombre de secondes à ajouter à la date et l’heure de début pour calculer les valeurs de date et d’heure de fin, de secondes et de secondes totales.
    Tableau 3. Renvoie
    Type Description
    Booléen Faux si la valeur entrée n’est pas un nombre. 
    var gdt = new GlideDateTime("2020-05-01 00:00:00");

var dc = new DurationCalculator();
dc.setStartDateTime(gdt);

if(!dc.calcDuration(2*24*3600)){ // 2 days
  gs.log("*** Error calculating duration");
  return;
}
var secs = dc.getSeconds();
var totalSecs = dc.getTotalSeconds();

gs.print("***SCHEDULE DURATION: SECS=" + secs + " TOTALSECS=" + totalSecs + " ENDTIME = " + endDateTime);

    Sortie

    ***SCHEDULE DURATION: SECS=172800 TOTALSECS=970534 ENDTIME = 2020-05-03 00:00:00

    DurationCalculator : calcRelativeDueDate (GlideDateTime début, nombre de jours, chaîne endTime)

    Calcule la date d’échéance en commençant à l’heure de début transmise et en ajoutant le nombre de jours à l’aide de la planification et du fuseau horaire actuels.

    Appelé à partir des définitions de durée relative, initiées par calcRelativeDuration(), en tant que calculator.calcRelativeDueDate(calculator.startDateTime, days). Une fois que le jour d’échéance des travaux est déterminé, la méthode définit l’heure de passage endTime de ce jour. S’il ne reste pas assez de jours dans la planification, utilise le dernier jour de la planification.

    Tableau 4. Paramètres
    Nom Type Description
    début GlideDateTime Objet GlideDateTime contenant la date de début du calcul.
    jours Numéro Nombre de jours à ajouter à la date de début.
    endTime Chaîne Heure de la journée à laquelle le travail est dû à la date d’échéance calculée.

    Si ce champ est vide, la fin de la journée de travail est définie par défaut.

    Format : HH :mm :ss
    Tableau 5. Renvoie
    Type Description
    Booléen Marqueur indiquant si la date d’achèvement est comprise dans le calendrier.
    Valeurs possibles :
    • vrai : la date d’achèvement est comprise dans le calendrier.
    • faux : la date d’achèvement n’est pas prévue dans le calendrier. Non défini si aucun calendrier n’a été défini avant l’appel de cette méthode.
    		 
    var dc = new DurationCalculator();
var startTime = new GlideDateTime();

// Settings for calculations
// Optional: Specify the schedule to use for the following calculations
dc.setSchedule('08fcd0830a0a0b2600079f56b1adb9ae'); 
// Optional: Specify a different timezone to use
dc.setTimeZone("Los Angeles");
// Optional: Set a start date and time, otherwise the current time is assumed
dc.setStartDateTime("2020-04-10 08:00:00")
// Calculate end time, from number of seconds required in the schedule
dc.calcDuration(3*24*3600); // 3 days
dc.calcRelativeDueDate(startTime, "3", "07:00:00");

    DurationCalculator : calcRelativeDuration(String relativeDurationID)

    Calcule la durée à l’aide du script de durée relative spécifié.

    Une fois l’opération terminée, les this.endDateTime propriétés et this.seconds sont définies pour indiquer les résultats du calcul.

    Tableau 6. Paramètres
    Nom Type Description
    relativeDurationID Chaîne sys_id du calendrier de durée relative (tableau cmn_relative_duration).
    Tableau 7. Renvoie
    Type Description
    Booléen Résultat du script de durée. 
    var dc = new DurationCalculator();
dc.calcRelativeDuration('08fcd0830a0a1b2600074f56b1ad7cb');

    DurationCalculator : calcScheduleDuration(Chaîne startTime, Chaîne endTime)

    Renvoie la durée entre le startTime et dans endTime le cadre de la planification déjà spécifiée et éventuellement du fuseau horaire remplacé.

    Cette méthode définit this.endDateTimeégalement , this.secondset this.totalSeconds dans l’objet de calendrier actuel.

    Tableau 8. Paramètres
    Nom Type Description
    startTime Chaîne Facultatif. Valeur d’affichage pour l’heure de fin.

    Par défaut : utilise la date et l’heure actuelles (définies à l’aide de setStartDateTime()). Vous devez transmettre un espace réservé s’il n’a pas été transmis à ce paramètre, par exemple dur.calcScheduleDuration(«  », endDateTime) ;.
    endTime Chaîne Facultatif. Valeur d’affichage pour l’heure de début.

    Par défaut : utilise la date et l’heure actuelles (définies à l’aide de setEndDateTime()).
    Tableau 9. Renvoie
    Type Description
    Numéro Durée du calendrier. Renvoie 0 si endTime est antérieur à startTime.

    Unité : Secondes

    		 
    var dur = new DurationCalculator();

// Set 9-5 weekday schedule. This is the schedule in which endDateTime, seconds, and totalseconds is set
dur.setSchedule('08fcd0830a0a0b2600079f56b1adb9ae');
dur.calcScheduleDuration("2019-01-02 11:00:00", "2019-01-06 09:00:00");
var secs = dur.getSeconds();
var totalSecs = dur.getTotalSeconds();
var endDateTime = dur.getEndDateTime() + "";

gs.print("***SCHEDULE DURATION: SECS=" + secs + " TOTALSECS=" + totalSecs + " ENDTIME = " + endDateTime);

    Sortie

    ***SCHEDULE DURATION: SECS=97200 TOTALSECS=338400 ENDTIME = 2019-01-06 09:00:00

    DurationCalculator : calcScheduleDuration(GlideDateTime startTime, GlideDateTime endTime)

    Renvoie la durée entre le startTime et dans endTime le cadre de la planification déjà spécifiée et éventuellement du fuseau horaire remplacé.

    Cette méthode définit this.endDateTimeégalement , this.secondset this.totalSeconds dans l’objet de calendrier actuel.

    Tableau 10. Paramètres
    Nom Type Description
    startTime GlideDateTime Facultatif. Objet GlideDateTime contenant l’heure de début à utiliser.

    Par défaut : utilise la date et l’heure actuelles (définies à l’aide de setStartDateTime()). Vous devez transmettre un espace réservé s’il n’a pas été transmis à ce paramètre, par exemple dur.calcScheduleDuration(«  », endDateTime) ;.
    endTime GlideDateTime Facultatif. Objet GlideDateTime contenant l’heure de fin à utiliser.

    Par défaut : utilise la date et l’heure actuelles (définies à l’aide de setEndDateTime()).
    Tableau 11. Renvoie
    Type Description
    Numéro Durée du calendrier. Renvoie 0 si endTime est antérieur à startTime.

    Unité : Secondes

    		 
    var startDateTime = new GlideDateTime("2020-11-02 11:00:00");
// Instantiate a new GlideDateTime object which has the end date as the current date and time
var endDateTime = new GlideDateTime(); 
var dur = new DurationCalculator();

// Set 9-5 weekday schedule. This is the schedule in which endDateTime, seconds, and totalseconds is set
dur.setSchedule('08fcd0830a0a0b2600079f56b1adb9ae'); 
dur.calcScheduleDuration(startDateTime, endDateTime);
var secs = dur.getSeconds();
var totalSecs = dur.getTotalSeconds();

gs.print("***SCHEDULE DURATION: SECS=" + secs + " TOTALSECS=" + totalSecs + " ENDTIME = " + endDateTime);

    Sortie

    ***SCHEDULE DURATION: SECS=293734.24 TOTALSECS=970534 ENDTIME = 2020-11-13 16:35:34

    DurationCalculator : getEndDateTime( )

    Obtient la endDateTime propriété définie par calcDuration/calcRelativeDuration, indiquant la date et l’heure de fin de la durée.

    Tableau 12. Paramètres
    Nom Type Description
    Néant
    Tableau 13. Renvoie
    Type Description
    GlideDateTime Date/heure de fin. 
    var dc = new DurationCalculator();
dc.calcDuration(52);
gs.print(dc.getEndDateTime());

    2012-04-17 20:57:27

    DurationCalculator : getSeconds( )

    Retourne la this.seconds propriété définie par calcDuration/calcRelativeDuration, indiquant le nombre total de secondes de travail à effectuer pour la durée.

    Il s’agit du temps de travail total, et non du temps total entre les heures de début et de fin, et peut être utilisé pour déterminer les pourcentages du temps de travail.

    Tableau 14. Paramètres
    Nom Type Description
    Néant
    Tableau 15. Renvoie
    Type Description
    Numéro Temps de travail total, en secondes. 
    var startDateTime = new GlideDateTime("2020-11-02 11:00:00");
// Instantiate a new GlideDateTime object which has the end date as the current date and time
var endDateTime = new GlideDateTime(); 
var dur = new DurationCalculator();

// Set 9-5 weekday schedule. This is the schedule in which endDateTime, seconds, and totalseconds is set
dur.setSchedule('08fcd0830a0a0b2600079f56b1adb9ae'); 
dur.calcScheduleDuration(startDateTime, endDateTime);
var secs = dur.getSeconds();
var totalSecs = dur.getTotalSeconds();

gs.print("***SCHEDULE DURATION: SECS=" + secs + " TOTALSECS=" + totalSecs + " ENDTIME = " + endDateTime);

    Sortie

    ***SCHEDULE DURATION: SECS=293734.24 TOTALSECS=970534 ENDTIME = 2020-11-13 16:35:34

    DurationCalculator : getTotalSeconds( )

    Renvoie la totalSeconds valeur définie par un appel à calculer (enregistrer).

    La totalSeconds propriété représente le nombre total de secondes entre les heures de début et de fin de la durée, qui inclut à la fois le travail et le non-travail.

    Tableau 16. Paramètres
    Nom Type Description
    Néant
    Tableau 17. Renvoie
    Type Description
    Numéro Nombre total de secondes. 
    var startDateTime = new GlideDateTime("2020-11-02 11:00:00");
// Instantiate a new GlideDateTime object which has the end date as the current date and time
var endDateTime = new GlideDateTime(); 
var dur = new DurationCalculator();

// Set 9-5 weekday schedule. This is the schedule in which endDateTime, seconds, and totalseconds is set
dur.setSchedule('08fcd0830a0a0b2600079f56b1adb9ae'); 
dur.calcScheduleDuration(startDateTime, endDateTime);
var secs = dur.getSeconds();
var totalSecs = dur.getTotalSeconds();

gs.print("***SCHEDULE DURATION: SECS=" + secs + " TOTALSECS=" + totalSecs + " ENDTIME = " + endDateTime);

    Sortie

    ***SCHEDULE DURATION: SECS=293734.24 TOTALSECS=970534 ENDTIME = 2020-11-13 16:35:34

    DurationCalculator : isAfter(GlideDateTime dt, String tm)

    Compare le temps transmis à la valeur temporelle de l’objet GlideDateTime transmis.

    Tableau 18. Paramètres
    Nom Type Description
    dt GlideDateTime ou chaîne Un objet GlideDateTime ou une date et une heure de valeur d’affichage à comparer à la valeur transmise tm . Si vous transmettez une date et une heure de valeur d’affichage, la méthode la convertit en objet GlideDateTime.
    tm Chaîne Afficher la valeur de temps à comparer à la valeur de temps dans l’objet GlideDateTime. Suppose la même date.

    Format : HH :mm :ss
    Tableau 19. Renvoie
    Type Description
    Booléen Marqueur indiquant si la valeur de temps transmise (tm) est postérieure à l’heure de l’objet GlideDateTime (dt).
    Valeurs possibles :
    • vrai : tm est après dt.
    • false n’est tm pas après dt.
    		 
    var dc = new DurationCalculator();
gs.print(dc.isAfter("2020-04-10 08:00:00", "09:00:00"));

    Script : vrai

    DurationCalculator : setSchedule(String schedId, String timezone)

    Définit la planification et le fuseau horaire à utiliser pour calculer la date d’échéance.

    Tableau 20. Paramètres
    Nom Type Description
    schedId Chaîne Sys_id du calendrier à définir.

    Table : Calendrier [cmn_schedule].
    fuseau horaire Chaîne Facultatif. Fuseau horaire à définir.

    Par défaut : fuseau horaire de l’utilisateur.
    Tableau 21. Renvoie
    Type Description
    nul

    L’exemple de code suivant montre comment appeler cette méthode.

    var startDateTime = new GlideDateTime("2020-11-02 11:00:00");
// Instantiate a new GlideDateTime object which has the end date as the current date and time
var endDateTime = new GlideDateTime(); 
var dur = new DurationCalculator();

// Set 9-5 weekday schedule. This is the schedule in which endDateTime, seconds, and totalseconds is set
dur.setSchedule('08fcd0830a0a0b2600079f56b1adb9ae'); 
dur.calcScheduleDuration(startDateTime, endDateTime);
var secs = dur.getSeconds();
var totalSecs = dur.getTotalSeconds();

gs.print("***SCHEDULE DURATION: SECS=" + secs + " TOTALSECS=" + totalSecs + " ENDTIME = " + endDateTime);

    Sortie :

    ***SCHEDULE DURATION: SECS=293734.24 TOTALSECS=970534 ENDTIME = 2020-11-13 16:35:34

    DurationCalculator : setStartDateTime(début de chaîne)

    Définit la date et l’heure de début des calculs de durée.

    Tableau 22. Paramètres
    Nom Type Description
    début Chaîne Afficher la valeur de l’heure de début en GMT pour les calculs ultérieurs.
    Tableau 23. Renvoie
    Type Description
    nul 
    var dc = new DurationCalculator();
dc.setStartDateTime("2020-04-10 08:00:00")

    DurationCalculator : setStartDateTime(description GlideDateTime)

    Définit la date et l’heure de début des calculs de durée.

    Tableau 24. Paramètres
    Nom Type Description
    description GlideDateTime Objet GlideDateTime qui contient l’heure de début en GMT pour les calculs ultérieurs.
    Tableau 25. Renvoie
    Type Description
    nul 
    var startDateTime = new GlideDateTime("2020-11-02 11:00:00"); 
var dur = new DurationCalculator();

// Set 9-5 weekday schedule.
dur.setSchedule('08fcd0830a0a0b2600079f56b1adb9ae'); 
dur.setStartDateTime(startDateTime);

    DurationCalculator : setTimeZone(String timezone)

    Définit le fuseau horaire à utiliser pour calculer la date d’échéance.

    Tableau 26. Paramètres
    Nom Type Description
    fuseau horaire Chaîne Valeur du fuseau horaire.
    Tableau 27. Renvoie
    Type Description
    nul 
    var dc = new DurationCalculator();
dc.setTimeZone("Los Angeles");