GlideTime : délimité

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

    • L’API GlideTime fournit des méthodes pour effectuer des opérations sur les 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 et d’heure avec une liste de conflits de format courants, reportez-vous à .Directives relatives aux formats de date et d’heure

    GlideTime : GlideTime()

    Instancie un objet GlideTime avec l’heure actuelle.

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

    GlideTime : GlideTime (nombre de millisecondes)

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

    La valeur est ajustée en fonction du fuseau horaire dans lequel réside l’instance. Par exemple, si l’instance de l’utilisateur se trouve dans un fuseau horaire situé à -8 heures de l’heure UTC et que 1 000 est transmis, l’heure dans l’objet GlideTime est 16:00:10 (00:00:00 - 8 heures +10 secondes).

    Tableau 2. Paramètres
    Nom Type Description
    millisecondes Numéro Heure à ajouter à minuit UTC.

    Unité : millisecondes

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

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

    Sortie :

    16:00:10

    GlideTime : 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 dans cette méthode, voir Format de 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 3. 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 h
    • s :m :H ss :mm :hh = 20:30:10 20:30:10
    • HH/mm/ss = 10/30/20
    Tableau 4. 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 : 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 d’includes de script, n’oubliez pas que cette méthode peut renvoyer des valeurs dans des formats différents pour différents utilisateurs.

    Tableau 5. Paramètres
    Nom Type Description
    Néant
    Tableau 6. 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 : getDisplayValueEx(style de chaîne)

    Renvoie l’heure à l’aide du fuseau horaire de l’utilisateur actuel et d’un format spécifié.

    Tableau 7. Paramètres
    Nom Type Description
    Le style Chaîne Format à utiliser pour l’heure.
    Valeurs valides (insensibles à la casse) :
    • abrégé : HH :mm (AM/PM)
    • moyen : HH :mm :ss (AM/PM)
    • long : HH :mm :ss (AM/PM) abréviation du fuseau horaire
    • complet : HH :mm :ss (AM/PM) fuseau horaire

    L’heure est renvoyée dans la langue de l’utilisateur actuel. La langue détermine si l’heure est renvoyée au format 12 heures ou 24 heures.
    Tableau 8. Renvoie
    Type Description
    Chaîne L’heure au format spécifié.

    Cet exemple renvoie l’heure à l’aide du fuseau horaire de l’utilisateur actuel et de chaque option de formatage.

    var gt = new GlideTime();
gs.info(gt.getDisplayValueEx("short"));
gs.info(gt.getDisplayValueEx("medium"));
gs.info(gt.getDisplayValueEx("long"));
gs.info(gt.getDisplayValueEx("full"));

    Sortie :

    8:52 AM  //short
8:52:24 AM  //medium
8:52:24 AM PST  //long
8:52:24 AM Pacific Standard Time  //full

    GlideTime : getDisplayValueInternal()

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

    Tableau 9. Paramètres
    Nom Type Description
    Néant
    Tableau 10. Renvoie
    Type Description
    Chaîne Valeur d’heure de l’objet GlideTime dans le fuseau horaire de l’utilisateur actuel et 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 : getDisplayValueLang(style de chaîne, langage de chaîne)

    Renvoie l’heure à l’aide du fuseau horaire de l’utilisateur actuel et d’un format et d’une langue spécifiés.

    Tableau 11. Paramètres
    Nom Type Description
    Le style Chaîne Format à utiliser pour l’heure.
    Valeurs valides (insensibles à la casse) :
    • abrégé : HH :mm (AM/PM)
    • moyen : HH :mm :ss (AM/PM)
    • long : HH :mm :ss (AM/PM) abréviation du fuseau horaire
    • complet : HH :mm :ss (AM/PM) fuseau horaire
    language Chaîne Facultatif. Langue de retour de l’heure, fournie sous forme de balise de langue BCP 47. Par exemple, pour renvoyer l’heure en japonais, utilisez la balise ja.

    La langue détermine si l’heure est renvoyée au format 12 heures ou 24 heures. Par exemple, les temps en anglais utilisent le format 12 heures, tandis que les temps en japonais utilisent le format 24 heures.

    Par défaut : langue de l’utilisateur actuel.
    Tableau 12. Renvoie
    Type Description
    Chaîne L’heure au format et dans la langue spécifiés.

    Cet exemple renvoie l’heure en espagnol à l’aide du fuseau horaire de l’utilisateur actuel et de chaque option de formatage.

    var gt = new GlideTime();
gs.info(gt.getDisplayValueLang("short", "es"));
gs.info(gt.getDisplayValueLang("medium", "es"));
gs.info(gt.getDisplayValueLang("long", "es"));
gs.info(gt.getDisplayValueLang("full", "es"));

    Sortie :

    9:25  //short
9:25:44  //medium
9:25:44 PST  //long
9:25:44 (hora estándar del Pacífico)  //full

    GlideTime : getHourLocalTime()

    Renvoie la partie du temps consacrée aux heures à l’aide du fuseau horaire local.

    Tableau 13. Paramètres
    Nom Type Description
    Néant
    Tableau 14. Renvoie
    Type Description
    Numéro Heures utilisant le fuseau horaire local.

    GlideTime : getHourOfDayLocalTime()

    Renvoie la partie du temps consacrée aux heures à l’aide du fuseau horaire local. Le nombre d’heures est basé sur une horloge de 24 heures.

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

    GlideTime : getHourOfDayUTC()

    Renvoie la partie des heures de l’heure à l’aide du fuseau horaire UTC. Le nombre d’heures est basé sur une horloge de 24 heures.

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

    GlideTime : getHourUTC()

    Renvoie la partie des heures de l’heure à l’aide du 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 19. Paramètres
    Nom Type Description
    Néant
    Tableau 20. 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 : getMinutesLocalTime()

    Renvoie le nombre de minutes à l’aide du fuseau horaire local.

    Tableau 21. Paramètres
    Nom Type Description
    Néant
    Tableau 22. Renvoie
    Type Description
    Numéro Nombre de minutes utilisant le fuseau horaire local.

    GlideTime : getMinutesUTC()

    Renvoie le nombre de minutes de l’heure en fonction du fuseau horaire UTC.

    Tableau 23. Paramètres
    Nom Type Description
    Néant
    Tableau 24. Renvoie
    Type Description
    Numéro Nombre de minutes dans l’heure utilisant le fuseau horaire UTC.

    GlideTime : getSeconds()

    Renvoie le nombre de secondes de la minute actuelle.

    Tableau 25. Paramètres
    Nom Type Description
    Néant
    Tableau 26. Renvoie
    Type Description
    Numéro Nombre de secondes dans la minute.

    GlideTime : getValue()

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

    Tableau 27. Paramètres
    Nom Type Description
    Néant
    Tableau 28. Renvoie
    Type Description
    Chaîne La valeur temporelle 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 : setDisplayValue(chaîne asDisplayed)

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

    Tableau 29. Paramètres
    Nom Type Description
    asDisplayed Chaîne L’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 30. 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 : setDisplayValueEx(durée de la chaîne, style de chaîne)

    Définit l’heure à l’aide du fuseau horaire de l’utilisateur actuel et d’un format spécifié.

    Tableau 31. Paramètres
    Nom Type Description
    heure Chaîne Valeur à définir pour l’heure.
    La méthode getDisplayValueEx() renvoie les heures dans un format valide, ou les heures peuvent être formatées comme indiqué ci-dessous.
    • HH :mm (AM/PM)
    • HH :mm :ss (AM/PM)
    • HH :mm :ss (AM/PM) abréviation du fuseau horaire
    • HH :mm :ss (AM/PM) fuseau horaire
    La langue de l’utilisateur actuel détermine si les valeurs d’heure de 12 heures (AM/PM) ou de 24 heures sont acceptées. Par exemple, si la langue de l’utilisateur actuel est l’anglais, 18 h 25 PST est une valeur valide alors que 18 h 25 PST ne l’est pas.
    Le style Chaîne Format à utiliser pour l’heure.

    Vous devez utiliser le même format que la valeur fournie time .

    Valeurs valides (insensibles à la casse) :
    • abrégé : HH :mm (AM/PM)
    • moyen : HH :mm :ss (AM/PM)
    • long : HH :mm :ss (AM/PM) abréviation du fuseau horaire
    • complet : HH :mm :ss (AM/PM) fuseau horaire
    Tableau 32. Renvoie
    Type Description
    Néant

    Cet exemple définit l’heure à l’aide du fuseau horaire de l’utilisateur actuel et d’un format spécifié.

    gt = new GlideTime();
gt.setDisplayValueEx("8:25:25 AM", "medium");
gs.info(gt.getDisplayValueEx("full"));

    Sortie :

    8:25:25 AM Pacific Standard Time

    GlideTime : setDisplayValueLang(durée de la chaîne, style de chaîne, langage de la chaîne)

    Définit l’heure à l’aide du fuseau horaire de l’utilisateur actuel et d’un format et d’une langue spécifiés.

    Tableau 33. Paramètres
    Nom Type Description
    heure Chaîne Valeur à définir pour l’heure.
    Les méthodes getDisplayValueLang() et getDisplayValueEx() renvoient des heures dans un format valide, ou les heures peuvent être formatées comme indiqué ci-dessous.
    • HH :mm (AM/PM)
    • HH :mm :ss (AM/PM)
    • HH :mm :ss (AM/PM) abréviation du fuseau horaire
    • HH :mm :ss (AM/PM) fuseau horaire
    Le language paramètre détermine si les valeurs d’heure de 12 heures (AM/PM) ou de 24 heures sont acceptées. Par exemple, si la langue est en (anglais), 18 h 25 PST est une valeur valide alors que 18 h 25 PST ne l’est pas.
    Le style Chaîne Format à utiliser pour l’heure.

    Vous devez utiliser le même format que la valeur fournie time .

    Valeurs valides (insensibles à la casse) :
    • abrégé : HH :mm (AM/PM)
    • moyen : HH :mm :ss (AM/PM)
    • long : HH :mm :ss (AM/PM) abréviation du fuseau horaire
    • complet : HH :mm :ss (AM/PM) fuseau horaire
    language Chaîne Langue dans laquelle définir l’heure, fournie en tant que balise de langue BCP 47. Par exemple, pour régler l’heure en japonais, utilisez la balise ja.
    Tableau 34. Renvoie
    Type Description
    Néant

    Cet exemple définit l’heure en anglais à l’aide du fuseau horaire de l’utilisateur actuel et la récupère en espagnol.

    gt = new GlideTime();
gt.setDisplayValueLang("4:15:00 PM PST", "long", "en");
gs.info(gt.getDisplayValueLang("full", "es"));

    Sortie :

    16:15:00 (hora estándar del Pacífico)

    GlideTime : setValue(Chaîne o)

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

    Tableau 35. Paramètres
    Nom Type Description
    o Chaîne L’heure au format hh :mm :ss.
    Tableau 36. 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 : soustraire(GlideTime startTime, GlideTime endTime)

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

    Tableau 37. Paramètres
    Nom Type Description
    startTime GlideTime Valeur de début.
    endTime GlideTime Valeur de fin.
    Tableau 38. Renvoie
    Type Description
    Durée 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());