GlideTime - Dans le champ d’application

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

    • La classe GlideTime incluse dans le champ d’application fournit des méthodes permettant d’effectuer des opérations sur des objets GlideTime, telles que l’instanciation d’objets GlideTime ou l’utilisation de champs GlideTime.

    Pour obtenir des conseils sur les chaînes d’entrée de date/heure avec une liste de conflits de format courants, reportez-vous à Directives relatives au format de la date et de l’heure.

    GlideTime inclus dans le champ d’application : getByFormat(format de chaîne)

    Renvoie l’heure au format spécifié.

    Pour plus d’informations sur les formats d’heure que vous pouvez transmettre à cette méthode, consultez Format du champ de date et d’heure global. Vous pouvez transmettre ces valeurs dans n’importe quel ordre et ajouter des séparateurs tels qu’un tiret, un espace, une barre oblique inverse ou deux-points. De plus, vous pouvez également passer le caractère « a » pour retourner am/pm.

    Tableau 1. Paramètres
    Nom Type Description
    format Chaîne Chaîne à utiliser pour formater l’heure.
    Par exemple, si l’heure actuelle est 10 :30 :20 alors :
    • hh :mm :ss = 10 :30 :20
    • HH = 10
    • HH –- ss = 10 –- 20
    • hh a = 10 AM
    • s :m :H ss :mm :hh = 20 :30 :10 20 :30 :10
    • HH :mm :ss. SSSZ = 10 :30 :20.000+0000
    • HH/mm/ss = 10/30/20
    Tableau 2. Renvoie
    Type Description
    Chaîne Heure au format spécifié. 
    var gt = new GlideTime(); 
gt.setValue('12:00:00');
gs.info(gt.getByFormat("HH:mm"));
    Sortie : 
    12:00

    GlideTime inclus dans le champ d’application : getDisplayValue()

    Obtient l’heure dans le format d’affichage et le fuseau horaire de l’utilisateur actuel.

    Lors de la conception de règles métier ou de script includes, n’oubliez pas que cette méthode peut renvoyer des valeurs dans différents formats pour différents utilisateurs.

    Tableau 3. Paramètres
    Nom Type Description
    Aucun
    Tableau 4. Renvoie
    Type Description
    Chaîne L’heure au format et dans le fuseau horaire de l’utilisateur. 
    var gt = new GlideTime();
gt.setDisplayValue("12:00:00"); // User Time Zone
gs.info(gt.getDisplayValue()); // User Time Zone

    GlideTime inclus dans le champ d’application : getDisplayValueInternal()

    Obtient la valeur d’affichage dans le fuseau horaire de l’utilisateur actuel et le format interne (HH :mm :ss).

    Tableau 5. Paramètres
    Nom Type Description
    Aucun
    Tableau 6. Renvoie
    Type Description
    Chaîne La valeur de temps de l’objet GlideTime dans le fuseau horaire de l’utilisateur actuel et le format d’heure interne HH :mm :ss. 
    var gt = new GlideTime();
gt.setValue("01:00:00"); //Internal Time Zone , UTC
gs.info(gt.getDisplayValueInternal()); //User Time Zone

    GlideTime inclus dans l’étendue : getHourLocalTime()

    Renvoie la partie heures du temps en utilisant le fuseau horaire local.

    Tableau 7. Paramètres
    Nom Type Description
    Aucun
    Tableau 8. Renvoie
    Type Description
    Numéro Heures utilisant le fuseau horaire local.

    GlideTime inclus dans l’étendue : getHourOfDayLocalTime()

    Renvoie la partie heures du temps en utilisant le fuseau horaire local. Le nombre d’heures est basé sur une horloge de 24 heures.

    Tableau 9. Paramètres
    Nom Type Description
    Aucun
    Tableau 10. Renvoie
    Type Description
    Numéro Heures utilisant le fuseau horaire local. Le nombre d’heures est basé sur une horloge de 24 heures.

    GlideTime inclus dans le champ d’application : getHourOfDayUTC()

    Renvoie la partie heures du temps en utilisant le fuseau horaire UTC. Le nombre d’heures est basé sur une horloge de 24 heures.

    Tableau 11. Paramètres
    Nom Type Description
    Aucun
    Tableau 12. Renvoie
    Type Description
    Numéro Heures utilisant le fuseau horaire UTC. Le nombre d’heures est basé sur une horloge de 24 heures.

    GlideTime inclus dans le champ d’application : getHourUTC()

    Renvoie la partie heures du temps en utilisant le fuseau horaire UTC. Le nombre d’heures est basé sur une horloge de 12 heures. Midi et minuit sont représentés par 0 et non par 12.

    Tableau 13. Paramètres
    Nom Type Description
    Aucun
    Tableau 14. Renvoie
    Type Description
    Numéro Heures utilisant le fuseau horaire UTC. Le nombre d’heures est basé sur une horloge de 12 heures. Midi et minuit sont représentés par 0 et non par 12.

    GlideTime inclus dans le champ d’application : getMinutesLocalTime()

    Renvoie le nombre de minutes en utilisant le fuseau horaire local.

    Tableau 15. Paramètres
    Nom Type Description
    Aucun
    Tableau 16. Renvoie
    Type Description
    Numéro Nombre de minutes en utilisant le fuseau horaire local.

    GlideTime inclus dans le champ d’application : getMinutesUTC()

    Renvoie le nombre de minutes dans l’heure basé sur le fuseau horaire UTC.

    Tableau 17. Paramètres
    Nom Type Description
    Aucun
    Tableau 18. Renvoie
    Type Description
    Numéro Nombre de minutes dans l’heure utilisant le fuseau horaire UTC.

    GlideTime inclus dans le champ d’application : getSeconds()

    Renvoie le nombre de secondes dans la minute actuelle.

    Tableau 19. Paramètres
    Nom Type Description
    Aucun
    Tableau 20. Renvoie
    Type Description
    Numéro Nombre de secondes dans la minute.

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

    Obtient la valeur de temps stockée dans la base de données par l’objet GlideTime au format interne, HH :mm :ss, et le fuseau horaire du système.

    Tableau 21. Paramètres
    Nom Type Description
    Aucun
    Tableau 22. Renvoie
    Type Description
    Chaîne Valeur d’heure dans le fuseau horaire interne et le fuseau horaire du système. 
    var gt = new GlideTime();
gs.info(gt.getValue()); // Internal Time Zone, UTC

    GlideTime inclus dans le champ d’application : GlideTime()

    Instancie un objet GlideTime avec l’heure actuelle.

    Tableau 23. Paramètres
    Nom Type Description
    Néant 
    var gt = new GlideTime(); 
gs.info(gt.getDisplayValue());

    GlideTime inclus dans le champ d’application : GlideTime(nombre de millisecondes)

    Instancie un objet GlideTime dont l’heure commence à minuit UTC plus la valeur transmise.

    La valeur est ajustée pour le fuseau horaire dans lequel se trouve l’instance. Par exemple, si l’instance de l’utilisateur se trouve dans un fuseau horaire distant de -8 heures par rapport à UTC et que la valeur 1000 est transmise, l’heure dans l’objet GlideTime est 16 :00 :10 (00 :00 :00 - 8 heures +10 secondes).

    Tableau 24. Paramètres
    Nom Type Description
    millisecondes Numéro Heure d’ajout à minuit UTC.

    Unité : millisecondes

    Cet exemple montre l’ajout de 10 secondes à minuit (UTC), qui est ensuite ajusté pour le fuseau horaire dans lequel l’instance réside. Dans ce cas, -8 heures à partir de UTC.

    var gt = new GlideTime(10000); 
gs.info(gt.getDisplayValue());

    Sortie

    16:00:10

    GlideTime inclus dans le champ d’application : setDisplayValue(String asDisplayed)

    Définit une valeur de temps à l’aide du format d’affichage et du fuseau horaire de l’utilisateur actuel.

    Tableau 25. Paramètres
    Nom Type Description
    asDisplayed Chaîne Heure dans le format d’affichage et le fuseau horaire de l’utilisateur actuel. Le paramètre doit être formaté à l’aide du format d’affichage préféré de l’utilisateur actuel, tel que HH :mm :ss.
    Tableau 26. Renvoie
    Type Description
    Néant 
    var gt = new GlideTime();
gt.setDisplayValue('01:00:00');   // User Time Zone
gs.info(gt.getDisplayValueInternal()); // User Time Zone

    GlideTime inclus dans le champ d’application : setValue(String o)

    Définit l’heure de l’objet GlideTime dans le fuseau horaire interne.

    Tableau 27. Paramètres
    Nom Type Description
    O Chaîne L’heure au format hh :mm :ss.
    Tableau 28. Renvoie
    Type Description
    Néant 
    var gt = new GlideTime();
gt.setValue('01:00:00');  //Internal Time Zone, UTC
gs.info("time is "+ gt.getByFormat('hh:mm:ss'));

    GlideTime inclus dans le champ d’application : soustraire (GlideTime startTime, GlideTime endTime)

    Obtient la différence de durée entre deux valeurs d’objet GlideTime.

    Tableau 29. Paramètres
    Nom Type Description
    startTime Temps Glide Valeur de début.
    endTime Temps Glide Valeur finale.
    Tableau 30. Renvoie
    Type Description
    GlideDuration (GlideDuration) Durée entre les deux valeurs. 
    var gd1 = new GlideTime(); 
gd1.setDisplayValue("09:00:00"); 
var gd2 = new GlideTime(); 
gd2.setDisplayValue("09:10:00"); 
 
var dur = GlideDate.subtract(gd1, gd2); //the difference between gdt1 and gdt2 
gs.info(dur.getDisplayValue());