GlideDate

Using GlideDate is something to avoid

Jace Benson

Table of content
  1. Methods available
  2. Detail
  3. getByFormat
  4. getDisplayValue
  5. getDisplayValueInternal
  6. getValue
  7. getDayOfMonth
  8. getDayOfWeek
  9. getDayOfYear
  10. getMonth
  11. getWeekOfYear
  12. getYear
  13. setDisplayValue
  14. setValue
  15. valueOf
  16. Usage note

GlideDate is the date-only counterpart to GlideDateTime. It handles year-month-day without a time component. Less common in practice β€” most date fields store datetime values, so you'll reach for GlideDateTime more often. But when you only need a date, this is the tool.

Docs

Methods available

Method Description
getByFormat Returns the date formatted per the given pattern
getDisplayValue Returns the date in the user's display format
getDisplayValueInternal Returns the date as yyyy-MM-dd
getValue Returns the date in internal format
getDayOfMonth Day of the month (1-31)
getDayOfWeek Day of the week (0=Sunday, 6=Saturday)
getDayOfYear Day of the year (1-366)
getMonth Month of the year (1-12)
getWeekOfYear Week number in the year
getYear Four-digit year
setDisplayValue Set the date from a display format string
setValue Set the date from internal format or another GlideDate
valueOf Milliseconds since epoch

Detail

getByFormat

Returns the date formatted according to the given Java date pattern.

var gd = new GlideDate();
gd.setValue('2024-03-15');
gs.info(gd.getByFormat('MM/dd/yyyy')); // 03/15/2024
gs.info(gd.getByFormat('MMMM dd, yyyy')); // March 15, 2024

getDisplayValue

Returns the date string in the user's session date format (e.g., yyyy-MM-dd, MM/dd/yyyy).

getDisplayValueInternal

Returns the date as yyyy-MM-dd regardless of user preferences.

getValue

Returns the date in the internal format (yyyy-MM-dd).

getDayOfMonth

Returns the day of the month as an integer (1-31).

getDayOfWeek

Returns the day of the week as an integer. 0 = Sunday, 6 = Saturday.

getDayOfYear

Returns the day of the year as an integer (1-366).

getMonth

Returns the month as an integer (1 = January, 12 = December).

getWeekOfYear

Returns the ISO week number as an integer (1-53).

getYear

Returns the year as a four-digit integer.

setDisplayValue

Sets the date from a display-format string. Parses using the user's session date format.

var gd = new GlideDate();
gd.setDisplayValue('2024-03-15');

setValue

Sets the date. Accepts either an internal-format date string (yyyy-MM-dd) or another GlideDate object.

var gd = new GlideDate();
gd.setValue('2024-03-15');

var gd2 = new GlideDate();
gd2.setValue(gd);

valueOf

Returns the epoch-time value for the date in milliseconds. Since GlideDate has no time component, this represents midnight UTC of the given date.

Usage note

This is the GlideDate object. It’s used less than the GlideDateTime object.