GlideTime : dans le champ d’application

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 des 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é en fonction du fuseau horaire dans lequel réside l’instance. Dans ce cas, -8 heures à partir de 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, une 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 = 30/10/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 actuels.

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 différents formats pour différents utilisateurs.

Tableau 5. Paramètres

Nom	Type	Description
Aucun

Tableau 6. Renvoie

Type	Description
Chaîne	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 : getDisplayValueInternal()

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

Tableau 7. Paramètres

Nom	Type	Description
Aucun

Tableau 8. Renvoie

Type	Description
Chaîne	Valeur temporelle 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 : getHourLocalTime()

Renvoie la partie du temps correspondant aux heures à l’aide du fuseau horaire local.

Tableau 9. Paramètres

Nom	Type	Description
Aucun

Tableau 10. Renvoie

Type	Description
Numéro	Les heures utilisant le fuseau horaire local.

GlideTime : getHourOfDayLocalTime()

Renvoie la partie du temps correspondant aux heures à l’aide du fuseau horaire local. 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	Les 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 à l’aide du fuseau horaire UTC. Le nombre d’heures est basé sur une horloge de 24 heures.

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 24 heures.

GlideTime : getHourUTC()

Renvoie la partie des heures à 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 15. Paramètres

Nom	Type	Description
Aucun

Tableau 16. 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 17. Paramètres

Nom	Type	Description
Aucun

Tableau 18. Renvoie

Type	Description
Numéro	Nombre de minutes utilisant le fuseau horaire local.

GlideTime : getMinutesUTC()

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

Tableau 19. Paramètres

Nom	Type	Description
Aucun

Tableau 20. Renvoie

Type	Description
Numéro	Nombre de minutes de l’heure en utilisant le fuseau horaire UTC.

GlideTime : getSeconds()

Renvoie le nombre de secondes dans la minute actuelle.

Tableau 21. Paramètres

Nom	Type	Description
Aucun

Tableau 22. 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 23. Paramètres

Nom	Type	Description
Aucun

Tableau 24. Renvoie

Type	Description
Chaîne	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 temporelle à 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 : 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 : 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	Délai GlideTime	Valeur de départ.
endTime	Délai GlideTime	Valeur de fin.

Tableau 30. 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());