GlideDuration : dans le champ d’application

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 4 minutes de lecture

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

    Les objets GlideDuration stockent la durée en tant que 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 autre)

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

    Tableau 2. Paramètres
    Nom Type Description
    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(String displayValue)

    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 qui contient 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 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 : 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 d’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
    Aucun
    Tableau 10. 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 11. Paramètres
    Nom Type Description
    Aucun
    Tableau 12. 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

    GlideDuration : getDurationValue()

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

    Tableau 13. Paramètres
    Nom Type Description
    Aucun
    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 à l’inférieur.

    Tableau 15. Paramètres
    Nom Type Description
    Aucun
    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
    Aucun
    Tableau 18. Renvoie
    Type Description
    Chaîne Durée actuelle dans l’objet GlideDuration.

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

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

    GlideDuration : setDisplayValue(String asDisplayed)

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

    Tableau 19. Paramètres
    Nom Type Description
    asDisplayed Chaîne Valeur de durée d’affichage à 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 de date/heure interne de l’objet GlideDuration.

    La méthode définit la valeur de la durée à la différence de la date/heure transmise à la date/heure de base du 1er janvier 1970, 00:00:00. L’objet date/heure transmis (chaîne) est analysé en 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 : JJ-MM-AAAA 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