GlideDuration : inclus dans le champ d’application

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 4 minutes de lecture

    • La classe GlideDuration fournit des méthodes permettant de travailler avec des intervalles de temps connus sous le nom de durées.

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

    GlideDuration : GlideDuration()

    Instancie un objet GlideDuration.

    Tableau 1. Paramètres
    Nom Type Description
    Aucun

    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
    autre GlideDuration (en anglais seulement) 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 : ajouter (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 GlideDuration (en anglais seulement) Objet GlideDuration qui contient la valeur de durée à ajouter à l’objet GlideDuration actuel.
    Tableau 6. Renvoie
    Type Description
    GlideDuration (en anglais seulement) 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 global de date et d’heure
    Tableau 8. Renvoie
    Type Description
    Chaîne Durée actuelle dans le 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 à l’unité supérieure. Sinon, il est arrondi à l’unité inférieure.

    Tableau 15. Paramètres
    Nom Type Description
    Aucun
    Tableau 16. Renvoie
    Type Description
    Numéro Valeur 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 interne de 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 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 Affichez la valeur de durée à régler.

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

    Sortie :

    3 Days 8 Hours

    GlideDuration : setValue(Object o)

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

    La méthode définit la valeur de durée à la différence de la date/heure de transmission de 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 : JJ-MM-AAAA HH :mm :ss
    Tableau 22. Renvoie
    Type Description
    Aucun 
    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 GlideDuration (en anglais seulement) Objet GlideDuration qui contient la valeur de durée à soustraire de l’objet GlideDuration actuel.
    Tableau 24. Renvoie
    Type Description
    GlideDuration (en anglais seulement) 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