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 des champs GlideTime.

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

GlideTime : GlideTime()

Instancie un objet GlideTime avec l’heure actuelle.

Tableau 1. Paramètres

Nom	Type	Description
Aucun

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’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 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 à 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 le matin et l’après-midi.

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

Tableau 5. Paramètres

Nom	Type	Description
Aucun

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 : getDisplayValueInternal()

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

Tableau 7. Paramètres

Nom	Type	Description
Aucun

Tableau 8. Renvoie

Type	Description
Chaîne	La valeur d’heure 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 : getHourLocalTime()

Renvoie les heures faisant partie du temps en utilisant le 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 les heures faisant partie du temps en utilisant le 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 heures de l’heure en utilisant le 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	Les heures utilisant le fuseau horaire UTC. Le nombre d’heures est basé sur une horloge de 24 heures.

GlideTime : getHourUTC()

Renvoie la partie heures de l’heure 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 15. Paramètres

Nom	Type	Description
Aucun

Tableau 16. Renvoie

Type	Description
Numéro	Les 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 en utilisant le fuseau horaire local.

Tableau 17. Paramètres

Nom	Type	Description
Aucun

Tableau 18. Renvoie

Type	Description
Numéro	Nombre de minutes en 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 dans 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 le fuseau horaire du système.

Tableau 23. Paramètres

Nom	Type	Description
Aucun

Tableau 24. Renvoie

Type	Description
Chaîne	Valeur horaire dans le fuseau horaire interne et système.

var gt = new GlideTime();
gs.info(gt.getValue()); // Internal Time Zone, UTC

GlideTime : setDisplayValue(String asDisplayed)

Définit une valeur d’heure en utilisant le format d’affichage et le 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
Aucun

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
Aucun

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	Heure de Glide	Valeur de départ.
endTime	Heure de Glide	Valeur de fin.

Tableau 30. Renvoie

Type	Description
GlideDuration (en anglais seulement)	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());