GlideDuration : inclus dans le champ d’application

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 4 minutes de lecture

    • La classe GlideDuration fournit des méthodes permettant d’utiliser des intervalles de temps appelés durées.

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

    GlideDuration inclus dans le champ d’application : add(durée GlideDuration)

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

    Tableau 1. Paramètres
    Nom Type Description
    durée GlideDuration (GlideDuration) Objet GlideDuration qui contient la valeur de durée à ajouter à l’objet GlideDuration actuel.
    Tableau 2. Renvoie
    Type Description
    GlideDuration (GlideDuration) Nouvel objet GlideDuration dont la durée est 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 inclus dans le champ d’application : getByFormat(format de chaîne)

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

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

    Format : format de champ de date et d’heure global
    Tableau 4. 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 inclus dans l’étendue : getDayPart()

    Renvoie le nombre de jours.

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

    Sortie

    3

    GlideDuration inclus 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 7. Paramètres
    Nom Type Description
    Aucun
    Tableau 8. Renvoie
    Type Description
    Chaîne Nombre de jours, d’heures et de 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

    Champ d’application GlideDuration : GlideDuration()

    Instancie un objet GlideDuration.

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

    GlideDuration inclus dans le champ d’application : getDurationValue()

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

    Tableau 10. Paramètres
    Nom Type Description
    Aucun
    Tableau 11. 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 inclus dans le périmètre : getRoundedDayPart()

    Renvoie le nombre arrondi de jours. Si la partie heure est supérieure à 12 heures, la valeur de retour est arrondie à l’unité supérieure. Sinon, il est arrondi à l’unité inférieure.

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

    Sortie

    4

    GlideDuration inclus dans le champ d’application : getValue()

    Renvoie la valeur interne date/heure 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 14. Paramètres
    Nom Type Description
    Aucun
    Tableau 15. 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

    Scoped GlideDuration : GlideDuration(GlideDuration another)

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

    Tableau 16. Paramètres
    Nom Type Description
    Autre GlideDuration (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 inclus dans le champ d’application : GlideDuration(nombre de millisecondes)

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

    Tableau 17. 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 inclus dans le périmètre : GlideDuration(String displayValue)

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

    Tableau 18. 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 inclus dans le champ d’application : setDisplayValue(String asDisplayed)

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

    Tableau 19. Paramètres
    Nom Type Description
    asDisplayed Chaîne Affichez 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 inclus dans le périmètre : setValue(Object o)

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

    La méthode définit la valeur de durée à la différence entre la date/heure transmise 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 inclus dans le champ d’application : subtract(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 GlideDuration (GlideDuration) Objet GlideDuration qui contient la valeur de durée à soustraire de l’objet GlideDuration actuel.
    Tableau 24. Renvoie
    Type Description
    GlideDuration (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