GlideDate- Global

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

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

See also GlideDateTime - Global.

Parent Topic:Server API reference

GlideDate - GlideDate()

Creates a GlideDate object with the current date time.

//Today's date is April 21, 2021
var gd = new GlideDate();
gs.info(gd.getValue());

Output:

2021-04-21

GlideDate - getByFormat(String format)

Gets the date in the specified date format.

var gd = new GlideDate(); 
gd.setValue('2021-04-21');
gs.info(gd.getByFormat("dd-MM-yyyy"));

Output:

21-04-2021

Scoped equivalent

To use this method in a scoped application, use the corresponding scoped method: Scoped GlideDate - getByFormat(String format).

GlideDate - getDayOfMonthNoTZ()

Gets the day of the month stored by the GlideDate object, expressed in the UTC time zone.

//Today's date is 2016-05-13 
var gd =new GlideDate();
gs.info(gd.getDayOfMonthNoTZ());

Output:

13

Scoped equivalent

To use this method in a scoped application, use the corresponding scoped method: Scoped GlideDate - getMonthNoTZ().

GlideDate - getDisplayValue()

Gets the date and time field value in the UTC time zone.

See also: Scoped GlideDate - getDisplayValue()

var gd = new GlideDate(); 
gd.setValue('2025-04-21');
gs.info(gd.getDisplayValue());

Output:

2025-04-21

Scoped equivalent

To use this method in a scoped application, use the corresponding scoped method: Scoped GlideDate - getDisplayValue().

GlideDate - getDisplayValueEx(String style)

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

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

var gd = new GlideDate();
gs.info(gd.getDisplayValueEx("short"));
gs.info(gd.getDisplayValueEx("medium"));
gs.info(gd.getDisplayValueEx("long"));
gs.info(gd.getDisplayValueEx("full"));

Output:

1/27/26  //short
Jan 27, 2026  //medium
January 27, 2026  //long
Tuesday, January 27, 2026  //full

Scoped equivalent

To use this method in a scoped application, use the corresponding scoped method: Scoped GlideDate - getDisplayValueEx(String style).

GlideDate - getDisplayValueInternal()

Gets the date in the internal format (yyyy-MM-dd) and current user's timezone.

See also getDisplayValue()

var gd = new GlideDate(); 
gs.info(gd.getDisplayValueInternal());

Output:

2021-04-21

Scoped equivalent

To use this method in a scoped application, use the corresponding scoped method: Scoped GlideDate - getDisplayValueInternal().

GlideDate - getDisplayValueLang(String style)

Returns the date value in the user's locale according to a specified date style.

The following example returns the date of the user's locale in all styles.

var gd = new GlideDate(); // This will fetch the current date


gs.info('date: ' + gd.getDisplayValue());

gs.info('date: ' + gd.getDisplayValueLang("full"));
gs.info('date: ' + gd.getDisplayValueLang("long"));
gs.info('date: ' + gd.getDisplayValueLang("medium"));
gs.info('date: ' + gd.getDisplayValueLang("short"));

Output:

date: 2023-01-18
Wednesday, January 18, 2023
date: January 18, 2023
date: Jan 18, 2023
date: 1/18/23

GlideDate - getDisplayValueLang(String style, String language)

Returns the date value in the user's locale and language according to a specified date style.

The following example returns the date of the user's locale in various languages and styles.

var gd = new GlideDate(); // This will fetch the current date


gs.info('date: ' + gd.getDisplayValue());

gs.info('date: ' + gd.getDisplayValueLang("full", "fr"));
gs.info('date: ' + gd.getDisplayValueLang("long", "en-GB"));
gs.info('date: ' + gd.getDisplayValueLang("medium", "de"));
gs.info('date: ' + gd.getDisplayValueLang("short", "es-MX"));

Output:

date: 2023-01-18
date: mercredi 18 janvier 2023
date: 18 January 2023
date: 18.01.2023
date: 18/01/23

GlideDate - getMonthNoTZ()

Gets the month stored by the GlideDate object, expressed in the UTC time zone.

//Today's date is 2016-05-13
var gd =new GlideDate();
gs.info(gd.getMonthNoTZ());

Output:

5

Scoped equivalent

To use this method in a scoped application, use the corresponding scoped method: Scoped GlideDate - getMonthNoTZ().

GlideDate - getYearNoTZ()

Gets the year stored by the GlideDate object, expressed in the UTC time zone.

//Today's date is 2016-05-13
var gd =new GlideDate();
gs.info(gd.getYearNoTZ());

Output:

2016

Scoped equivalent

To use this method in a scoped application, use the corresponding scoped method: Scoped GlideDate - getYearNoTZ().

GlideDate - parseDate(String date, String language, String country)

Parses a date to the locale associated with the passed language and country codes.

Note: This method fails and throws an exception if the regional date format isn't followed.

The following code example parses a date and adds four weeks to that date.

var date = GlideDate.parseDate("31 Dec 2020", "en", "GB");
date.addWeeksLocalTime(4);
gs.info("Project is due 4 weeks after start date, on " + date.getDisplayValue());

Output:

Project is due 4 weeks after start date, on 2021-01-28

GlideDate - setDisplayValue(String asDisplayed)

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

var gd = new GlideDate();
gd.setDisplayValue("2011-01-01");
gs.info(gd.getValue());

Output:

2011-01-01

Scoped equivalent

To use this method in a scoped application, use the corresponding scoped method: Scoped GlideDate - setDisplayValue(String asDisplayed).

GlideDate - setDisplayValueEx(String date, String style)

Sets the date using a specified format.

This example sets the date using a specified format.

gd = new GlideDate();
gd.setDisplayValueEx("Jan 28, 2026", "medium");
gs.info(gd.getDisplayValueEx("full"));

Output:

Wednesday, January 28, 2026

Scoped equivalent

To use this method in a scoped application, use the corresponding scoped method: Scoped GlideDate - setDisplayValueEx(String date, String style).

GlideDate - setDisplayValueLang(String date, String style)

Sets a date using a specified style and format according to the current user's locale.

The following example shows how you can set the current date of the user's locale to 'full' style using setDisplayValueLang().

glideDate.setDisplayValueLang("2/3/2023", "short");


gs.info('date: ' + glideDate.getDisplayValue());
gs.info('date: ' + glideDate.getDisplayValueLang("full"));

Output:

date: 2023-02-03
date: Friday, February 3, 2023

GlideDate - setDisplayValueLang(String date, String style, String language)

Sets a date using a specified style, language, and format according to the current user's locale.

The following example returns the date and time in short and full styles for English and French.

var glideDateFR = new GlideDate(); 

glideDateUS.setDisplayValueLang("2/3/202", "short", "en-US" );
glideDateFR.setDisplayValueLang("2/3/2023", "short", "fr-FR" );

gs.info('en-US date: ' + glideDateUS.getDisplayValue());
gs.info('en-US date: ' + glideDateUS.getDisplayValueLang("full"));

gs.info('fr-FR date: ' + glideDateFR.getDisplayValue());
gs.info('fr-FR date: ' + glideDateFR.getDisplayValueLang("full"));

Output:

en-US date: 2023-02-03
en-US date: Friday, February 3, 2023
fr-FR date: 2023-03-02
fr-FR date: Thursday, March 2, 2023

GlideDate - setValue(String o)

Sets the date of the current GlideDate object in internal format (yyyy-MM-dd) and the system time zone (UTC by default).

var gd = new GlideDate(); 
gd.setValue('2015-01-01');
gs.info(gd.getValue());

Output:

2015-01-01

Scoped equivalent

To use this method in a scoped application, use the corresponding scoped method: Scoped GlideDate - setValue(String o).