GlideDuration : délimité

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

    • La classe GlideDuration fournit des méthodes pour travailler avec des durées connues.

    Les objets GlideDuration stockent la durée sous forme de nombre de jours et d’heure à partir du 1er janvier 1970 à 00:00:00. Par conséquent, les méthodes setValue() et getValue() utilisent l’objet GlideDateTime étendu pour les paramètres et les valeurs de retour.

    GlideDuration : GlideDuration()

    Instancie un objet GlideDuration.

    Tableau 1. Paramètres
    Nom Type Description
    Néant

    GlideDuration : GlideDuration(GlideDuration un autre)

    Instancie un objet GlideDuration en clonant les valeurs de l’objet GlideDuration transmis.

    Tableau 2. Paramètres
    Nom Type Description
    un autre Durée GlideDuration Objet GlideDuration. 
    var duration = new GlideDuration('3 12:00:00');
var duration2 = new GlideDuration(duration);
gs.info(duration2.getDisplayValue());

    Sortie :

    3 Days 12 Hours

    GlideDuration : GlideDuration(nombre de millisecondes)

    Instancie un objet GlideDuration avec la durée spécifiée en millisecondes.

    Tableau 3. Paramètres
    Nom Type Description
    millisecondes Numéro Valeur de durée.

    Unité : millisecondes

    		 
    var dur = new GlideDuration(60000);
gs.info(dur.getDurationValue());

    Sortie :

    00:01:00

    GlideDuration : GlideDuration(valeur d’affichage de la chaîne)

    Instancie un objet GlideDuration avec la valeur d’affichage de durée spécifiée.

    Tableau 4. Paramètres
    Nom Type Description
    displayValue Chaîne Valeur de durée.

    Format : d HH :mm :ss où « d » est le nombre de jours.

    		 
    var duration = new GlideDuration('3 12:00:00');
var duration2 = new GlideDuration('3:00:00');
var answer = duration.add(duration2);
gs.info(answer.getDisplayValue());

    Sortie :

    3 Days 15 Hours

    GlideDuration : add(durée GlideDuration)

    Ajoute la durée de l’objet GlideDuration spécifié à l’objet GlideDuration actuel.

    Tableau 5. Paramètres
    Nom Type Description
    durée Durée GlideDuration Objet GlideDuration contenant la valeur de durée à ajouter à l’objet GlideDuration actuel.
    Tableau 6. Renvoie
    Type Description
    Durée GlideDuration Nouvel objet GlideDuration dont la durée correspond à la somme des durées des deux objets GlideDuration. 
    var duration = new GlideDuration('3 12:00:00');
var duration2 = new GlideDuration('3:00:00');
var answer = duration.add(duration2);
gs.info(answer.getDisplayValue());

    Sortie :

    3 Days 15 Hours

    GlideDuration : getByFormat(format de chaîne)

    Renvoie la valeur de durée au format spécifié.

    Tableau 7. Paramètres
    Nom Type Description
    format Chaîne Format de durée.

    Format : format de champ de date et heure global
    Tableau 8. Renvoie
    Type Description
    Chaîne Durée actuelle au format spécifié. 
    var dur = new GlideDuration('3 22:00:00');
gs.info(dur.getByFormat('HH:mm'));

    Sortie

    22:00

    GlideDuration : getDayPart()

    Renvoie le nombre de jours.

    Tableau 9. Paramètres
    Nom Type Description
    Néant
    Tableau 10. Renvoie
    Type Description
    Numéro Nombre de jours de la durée. 
    var dur = new GlideDuration('3 12:00:00');
gs.info(dur.getDayPart());

    Sortie :

    3

    GlideDuration dans le champ d’application : getDisplayValue()

    Renvoie la valeur d’affichage de la durée en nombre de jours, d’heures et de minutes.

    Tableau 11. Paramètres
    Nom Type Description
    Néant
    Tableau 12. Renvoie
    Type Description
    Chaîne Nombre de jours, heures et minutes, par exemple 2 jours 10 heures 36 minutes.

    Format : Valeur d’affichage : « n » Jours « n » Heures « n » Minutes

    		 
    var dur = new GlideDuration('3 12:00:00');
gs.info(dur.getDisplayValue());

    Sortie :

    3 Days 12 Hours

    GlideDuration : getDurationValue()

    Renvoie la valeur de durée au format « j HH :mm :ss ».

    Tableau 13. Paramètres
    Nom Type Description
    Néant
    Tableau 14. Renvoie
    Type Description
    Chaîne Valeur de durée.

    Format : d HH :mm :ss où « d » est le nombre de jours.

    		 
    var dur = new GlideDuration(60000);
gs.info(dur.getDurationValue());

    Sortie :

    00:01:00

    GlideDuration : getRoundedDayPart()

    Renvoie le nombre arrondi de jours. Si la partie temporelle est supérieure à 12 heures, la valeur de retour est arrondie à la hausse. Sinon, il est arrondi à la baisse.

    Tableau 15. Paramètres
    Nom Type Description
    Néant
    Tableau 16. Renvoie
    Type Description
    Numéro Valeur du jour de la valeur d’affichage arrondie. 
    var dur = new GlideDuration('3 14:00:00');
gs.info(dur.getRoundedDayPart());

    Sortie :

    4

    GlideDuration : getValue()

    Renvoie la valeur date/heure interne de l’objet GlideDuration actuel.

    Les objets GlideDuration stockent la durée sous forme de date et d’heure à partir du 1er janvier 1970 à 00:00:00.

    Tableau 17. Paramètres
    Nom Type Description
    Néant
    Tableau 18. Renvoie
    Type Description
    Chaîne Durée actuelle dans l’objet GlideDuration.

    Format : AAAA-MM-JJ HH :mm :ss

    		 
    var dur = new GlideDuration('3 12:00:00');
gs.info(dur.getValue());
    Sortie :
    1970-01-04 12:00:00

    GlideDuration : setDisplayValue (chaîne asDisplayed)

    Définit la valeur d’affichage de la durée.

    Tableau 19. Paramètres
    Nom Type Description
    asDisplayed Chaîne Afficher la valeur de durée à définir.

    Format : d HH :mm :ss où « d » est le nombre de jours
    Tableau 20. Renvoie
    Type Description
    Néant 
    var dur = new GlideDuration(); 
dur.setDisplayValue('3 08:00:00');
gs.info(dur.getDisplayValue());

    Sortie :

    3 Days 8 Hours

    GlideDuration : setValue(Objet o)

    Définit la valeur date/heure interne de l’objet GlideDuration.

    La méthode définit la valeur de la durée à la différence entre la date et l’heure transmises et la valeur date/heure de base du 1er janvier 1970 à 00:00:00. L’objet date/heure transmis (chaîne) est analysé en un objet GlideDateTime.

    Tableau 21. Paramètres
    Nom Type Description
    o Objet Date et heure à utiliser comme point de terminaison pour la durée calculée.

    Format : AAAA-MM-JJ HH :mm :ss
    Tableau 22. Renvoie
    Type Description
    Néant 
    var dur = new GlideDuration();
dur.setValue('1970-01-05 08:00:00'); // sets internal DateTime value. The String is parsed into a GlideDateTime object.
gs.info(dur.getDisplayValue());
    Sortie :
    4 Days 8 Hours

    GlideDuration : soustraire(Durée GlideDuration)

    Soustrait la durée de l’objet GlideDuration spécifié à l’objet GlideDuration actuel.

    Tableau 23. Paramètres
    Nom Type Description
    durée Durée GlideDuration Objet GlideDuration qui contient la valeur de durée à soustraire de l’objet GlideDuration actuel.
    Tableau 24. Renvoie
    Type Description
    Durée GlideDuration Nouvel objet GlideDuration dont la durée contient le résultat de la soustraction de la durée des deux objets GlideDuration. 
    var duration = new GlideDuration('3 12:00:00');
var duration2 = new GlideDuration('3:00:00');
var answer = duration.subtract(duration2);
gs.info(answer.getDisplayValue());
    Sortie :
    3 Days 9 Hours