GlideTime- Scoped

The GlideTime API provides methods for performing operations on GlideTime objects, such as instantiating GlideTime objects or working with GlideTime fields.

For guidance on date time input strings with a list of common format conflicts, refer to Date and time format guidelines.

Parent Topic:Server API reference

GlideTime - GlideTime()

Instantiates a GlideTime object with the current time.

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

GlideTime - GlideTime(Number milliseconds)

Instantiates a GlideTime object with its time starting at midnight UTC plus the passed in value.

The value is adjusted for the timezone in which the instance resides. For example, if the user's instance is in a time zone that is -8 hours from the UTC, and 1000 is passed in, the time in the GlideTime object is 16:00:10 (00:00:00 - 8 hours +10 seconds.)

This example shows adding 10 seconds to midnight (UTC), which is then adjusted for the time zone in which the instance resides. In this case, -8 hours from UTC.

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

Output:

16:00:10

GlideTime - getByFormat(String format)

Returns the time in the specified format.

For information on the time formats that you can pass into this method, see Global date and time field format. You can pass these values in any order and add separators such as a dash, space, backslash, or colon. In addition, you can also pass the character "a" to return am/pm.

var gt = new GlideTime(); 
gt.setValue('12:00:00');
gs.info(gt.getByFormat("HH:mm"));

Output:

12:00

GlideTime - getDisplayValue()

Gets the time in the current user's display format and time zone.

When designing business rules or script includes remember that this method may return values in different formats for different users.

var gt = new GlideTime();
gt.setDisplayValue("12:00:00"); // User Time Zone
gs.info(gt.getDisplayValue()); // User Time Zone

GlideTime - getDisplayValueEx(String style)

Returns the time using the current user's timezone and a specified format.

This example returns the time using the current user's timezone and each formatting option.

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

Output:

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

Gets the display value in the current user's time zone and the internal format (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(String style, String language)

Returns the time using the current user's timezone and a specified format and language.

This example returns the time in Spanish using the current user's timezone and each formatting option.

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"));

Output:

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

GlideTime - getHourLocalTime()

Returns the hours part of the time using the local time zone.

GlideTime - getHourOfDayLocalTime()

Returns the hours part of the time using the local time zone. The number of hours is based on a 24 hour clock.

GlideTime - getHourOfDayUTC()

Returns the hours part of the time using the UTC time zone. The number of hours is based on a 24 hour clock.

GlideTime - getHourUTC()

Returns the hours part of the time using the UTC time zone. The number of hours is based on a 12 hour clock. Noon and midnight are represented by 0, not 12.

GlideTime - getMinutesLocalTime()

Returns the number of minutes using the local time zone.

GlideTime - getMinutesUTC()

Returns the number of minutes in the hour based on the UTC time zone.

GlideTime - getSeconds()

Returns the number of seconds in the current minute.

GlideTime - getValue()

Gets the time value stored in the database by the GlideTime object in the internal format, HH:mm:ss, and the system time zone.

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

GlideTime - setDisplayValue(String asDisplayed)

Sets a time value using the current user's display format and time zone.

var gt = new GlideTime();
gt.setDisplayValue('01:00:00');   // User Time Zone
gs.info(gt.getDisplayValueInternal()); // User Time Zone

GlideTime - setDisplayValueEx(String time, String style)

Sets the time using the current user's timezone and a specified format.

This example sets the time using the current user's timezone and a specified format.

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

Output:

8:25:25 AM Pacific Standard Time

GlideTime - setDisplayValueLang(String time, String style, String language)

Sets the time using the current user's timezone and a specified format and language.

This example sets the time in English using the current user's timezone and retrieves it in Spanish.

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

Output:

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

GlideTime - setValue(String o)

Sets the time of the GlideTime object in the internal time zone.

var gt = new GlideTime();
gt.setValue('01:00:00');  //Internal Time Zone, UTC
gs.info("time is "+ gt.getByFormat('hh:mm:ss'));

GlideTime - subtract(GlideTime startTime, GlideTime endTime)

Gets the duration difference between two GlideTime object values.

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());