---
sourceDocument: Brazil API Reference
sourceDocumentLink: https://www.servicenow.com/docs/r/api-reference

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil API Reference

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# MobileGlideDate - Scoped

# MobileGlideDate - Scoped {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 7 minutes to read  
The MobileGlideDate API provides methods for working with date-only values (year, month, and day, with no time of day) in mobile scripts. This includes formatting a date for display, reading individual date
parts, or comparing dates.

MobileGlideDate provides the subset of GlideDate that can be evaluated against the local
database on a device. It represents the date-only portion of a [MobileGlideDateTime](https://www.servicenow.com/docs/NvYzicw7gURIEMK_3ZMN2A#MobileGlideDateTimeScopedAPI "The MobileGlideDateTime API provides methods for working with date and time values in mobile scripts. Capabilities include comparing two values, formatting a value for display, reading parts of a value like the month or day of the week, and checking time zone and daylight saving time information.") value, for scripts that need only the calendar date, such as a script that checks whether a due date falls on the current date, without accounting for the time of
day.

Whether a script that calls this API is evaluated on the instance or on the device depends on how the component that runs the script is configured. The methods in this class are available in both cases: the mobile client provides its
own implementation of the same API surface, so the same script returns the same result in either context. Typical calling contexts include a condition script on a mobile button (sys_sg_button) and an
execution script on a write-back action item or step.
This API contains the following capabilities:

* Formatting dates for display: [MobileGlideDate - getByFormat(String format)](https://www.servicenow.com/docs/IEgeHb7mWLFp6qF7InyL~Q#MGD-getByFormat_S "Gets the date value formatted with a date format pattern that you specify, such as MM/dd/yyyy or MMM d, yyyy."), [MobileGlideDate - getDisplayValue()](https://www.servicenow.com/docs/IEgeHb7mWLFp6qF7InyL~Q#MGD-getDisplayValue "Gets the date value formatted in the current user’s date display format. Use this method for dates that users read, such as dates in messages or labels.")
* Getting dates for storing and comparing: [MobileGlideDate - getValue()](https://www.servicenow.com/docs/IEgeHb7mWLFp6qF7InyL~Q#MGD-getValue "Gets the date value in the internal date format, yyyy-MM-dd, in the system time zone. Use this method for dates that you store or compare."), [MobileGlideDate - getDisplayValueInternal()](https://www.servicenow.com/docs/IEgeHb7mWLFp6qF7InyL~Q#MGD-getDisplayValueInternal "Gets the date value in the internal date format, yyyy-MM-dd, regardless of the current user’s date format preference."), [MobileGlideDate - getNumericValue()](https://www.servicenow.com/docs/IEgeHb7mWLFp6qF7InyL~Q#MGD-getNumericValue "Gets the date value as the number of milliseconds since January 1, 1970, 00:00:00 GMT. Use this method to compare, sort, or calculate the time between dates.")
* Getting parts of a date: [MobileGlideDate - getDayOfMonthNoTZ()](https://www.servicenow.com/docs/IEgeHb7mWLFp6qF7InyL~Q#MGD-getDayOfMonthNoTZ "Gets the day of the month from the date value as a number, without converting the date to the user’s or system time zone."), [MobileGlideDate - getMonthNoTZ()](https://www.servicenow.com/docs/IEgeHb7mWLFp6qF7InyL~Q#MGD-getMonthNoTZ "Gets the month from the date value as a number, without converting the date to the user’s or system time zone."), [MobileGlideDate - getYearNoTZ()](https://www.servicenow.com/docs/IEgeHb7mWLFp6qF7InyL~Q#MGD-getYearNoTZ "Gets the four-digit year from the date value, without converting the date to the user’s or system time zone.")
* Validating dates: [MobileGlideDate - isValid()](https://www.servicenow.com/docs/IEgeHb7mWLFp6qF7InyL~Q#MGD-isValid "Determines whether the MobileGlideDate object contains a valid date. Use this method to check a date before you format or compare it.")

For guidance on date time input strings with a list of common format conflicts, refer to [Server-side script use cases](https://www.servicenow.com/docs/T16C7mU7BHGDoHJDPxeUKg#useful-server-side-scripts "Use cases for server-side scripts include logging output, getting user objects, and modifying date/time values.").

## API access {#MobileGlideDateScopedAPI__section_ajw_lpp_lkc}

This API is registered in the sn_mobile_scripting application scope and requires the mobile_admin role. It requires the
com.glide.sg.mobile_scripting plugin, which is enabled by default. The class has no public constructor. Obtain an instance from the `getDate()` or `getLocalDate()` method
of [MobileGlideDateTime](https://www.servicenow.com/docs/NvYzicw7gURIEMK_3ZMN2A#MobileGlideDateTimeScopedAPI "The MobileGlideDateTime API provides methods for working with date and time values in mobile scripts. Capabilities include comparing two values, formatting a value for display, reading parts of a value like the month or day of the week, and checking time zone and daylight saving time information.").

## MobileGlideDate - getByFormat(String format) {#ariaid-title2}

Gets the date value formatted with a date format pattern that you specify, such as MM/dd/yyyy or MMM d, yyyy.
{#MGD-getByFormat_S__table_MGD-getByFormat_S_p__entry__3}

| Name | Type | Description |
|-|-|-|
| format | String | Date format pattern to apply to the date value. Use standard date pattern letters, such as yyyy for the four-digit year, MM for the two-digit month, MMM for the abbreviated month name, and dd for the two-digit day. Example: `"MM/dd/yyyy"` |
[Table 1. Parameters]

{#MGD-getByFormat_S__table_MGD-getByFormat_S_p} {#MGD-getByFormat_S__table_MGD-getByFormat_S_r__entry__2}

| Type | Description |
|-|-|
| String | Date value formatted with the specified pattern, such as 08/26/2026 for the pattern MM/dd/yyyy. |
[Table 2. Returns]

{#MGD-getByFormat_S__table_MGD-getByFormat_S_r}  
This example gets the current date and logs it in `MM/dd/yyyy` format.

    var dueDate = mgs.nowGlideDateTime().getDate();
    mgs.info(dueDate.getByFormat('MM/dd/yyyy'));

Output:

    "08/26/2026"

This example formats the current date as a readable label, such as text that a write-back action adds to a record's notes.

    var today = mgs.nowGlideDateTime().getDate();
    var label = 'Visit completed on ' + today.getByFormat('MMM d, yyyy');
    mgs.info(label);

Output:

    Visit completed on Aug 26, 2026

## MobileGlideDate - getDayOfMonthNoTZ() {#ariaid-title3}

Gets the day of the month from the date value as a number, without converting the date to the user's or system time zone.
{#MGD-getDayOfMonthNoTZ__table_MGD-getDayOfMonthNoTZ_p__entry__3}

| Name | Type | Description |
|-|-|-|
| None |   |   |
[Table 3. Parameters]

{#MGD-getDayOfMonthNoTZ__table_MGD-getDayOfMonthNoTZ_p} {#MGD-getDayOfMonthNoTZ__table_MGD-getDayOfMonthNoTZ_r__entry__2}

| Type | Description |
|-|-|
| Number | Day of the month for the date value, such as 26 for August 26. Range: 1-31 |
[Table 4. Returns]

{#MGD-getDayOfMonthNoTZ__table_MGD-getDayOfMonthNoTZ_r}  
This example gets the current date and logs the day of the month as a number, without adjusting for time zone.

    mgs.info(mgs.nowGlideDateTime().getDate().getDayOfMonthNoTZ());

Output:

    26

This example checks whether the current date falls within the first five days of the month. A button condition can use this check to show a Submit monthly time sheet button only during the submission window.

    var day = mgs.nowGlideDateTime().getDate().getDayOfMonthNoTZ();
    var inSubmissionWindow = day <= 5;
    mgs.info('Day ' + day + ', submission window open: ' + inSubmissionWindow);

Output:

    Day 26, submission window open: false

## MobileGlideDate - getDisplayValue() {#ariaid-title4}

Gets the date value formatted in the current user's date display format. Use this method for dates that users read, such as dates in messages or labels.
{#MGD-getDisplayValue__table_MGD-getDisplayValue_p__entry__3}

| Name | Type | Description |
|-|-|-|
| None |   |   |
[Table 5. Parameters]

{#MGD-getDisplayValue__table_MGD-getDisplayValue_p} {#MGD-getDisplayValue__table_MGD-getDisplayValue_r__entry__2}

| Type | Description |
|-|-|
| String | Date value in the current user's date display format, such as 08/26/2026 for a user whose format is MM/dd/yyyy. The format varies by user, so don't use this value to store or compare dates. |
[Table 6. Returns]

{#MGD-getDisplayValue__table_MGD-getDisplayValue_r}  
This example gets the current date and logs it in the current user's date display format.

    mgs.info(mgs.nowGlideDateTime().getDate().getDisplayValue());

Output:

    "08/26/2026"

This example builds a confirmation message that shows the date in the current user's date format. Use the display value for text that users read, and use getValue() for values that you store or compare.

    var today = mgs.nowGlideDateTime().getDate();
    mgs.info('Scheduled for ' + today.getDisplayValue());

Output:

    Scheduled for 08/26/2026

## MobileGlideDate - getDisplayValueInternal() {#ariaid-title5}

Gets the date value in the internal date format, yyyy-MM-dd, regardless of the current user's date format preference.
{#MGD-getDisplayValueInternal__table_MGD-getDisplayValueInternal_p__entry__3}

| Name | Type | Description |
|-|-|-|
| None |   |   |
[Table 7. Parameters]

{#MGD-getDisplayValueInternal__table_MGD-getDisplayValueInternal_p} {#MGD-getDisplayValueInternal__table_MGD-getDisplayValueInternal_r__entry__2}

| Type | Description |
|-|-|
| String | Date value in the yyyy-MM-dd format, such as 2026-08-26. The format is the same for every user. |
[Table 8. Returns]

{#MGD-getDisplayValueInternal__table_MGD-getDisplayValueInternal_r}  
This example gets the current date and logs it in the internal format, `yyyy-MM-dd`.

    mgs.info(mgs.nowGlideDateTime().getDate().getDisplayValueInternal());

Output:

    "2026-08-26"

This example builds a reference string in `yyyy-MM-dd` format, which stays the same regardless of the user's date format preference.

    var today = mgs.nowGlideDateTime().getDate();
            var inspectionRef = 'INSP-' + today.getDisplayValueInternal();
            mgs.info(inspectionRef);

Output:

    INSP-2026-08-26

## MobileGlideDate - getMonthNoTZ() {#ariaid-title6}

Gets the month from the date value as a number, without converting the date to the user's or system time zone.
{#MGD-getMonthNoTZ__table_MGD-getMonthNoTZ_p__entry__3}

| Name | Type | Description |
|-|-|-|
| None |   |   |
[Table 9. Parameters]

{#MGD-getMonthNoTZ__table_MGD-getMonthNoTZ_p} {#MGD-getMonthNoTZ__table_MGD-getMonthNoTZ_r__entry__2}

| Type | Description |
|-|-|
| Number | Month of the date value, where 1 is January and 12 is December. Range: 1--12 |
[Table 10. Returns]

{#MGD-getMonthNoTZ__table_MGD-getMonthNoTZ_r}  
This example gets the current date and logs the month as a number from 1 to 12, without adjusting for time zone.

    mgs.info(mgs.nowGlideDateTime().getDate().getMonthNoTZ());

Output:

    8

This example works out the current quarter and checks whether the current month is the first month of that quarter. A button condition can use this check to show a Start quarterly inspection button only at the start of each quarter.

    var month = mgs.nowGlideDateTime().getDate().getMonthNoTZ();
            var quarter = Math.ceil(month / 3);
            var isFirstMonthOfQuarter = (month % 3 === 1);
            mgs.info('Q' + quarter + ', first month of quarter: ' + isFirstMonthOfQuarter);

Output:

    Q3, first month of quarter: false

## MobileGlideDate - getNumericValue() {#ariaid-title7}

Gets the date value as the number of milliseconds since January 1, 1970, 00:00:00 GMT. Use this method to compare, sort, or calculate the time between dates.
{#MGD-getNumericValue__table_MGD-getNumericValue_p__entry__3}

| Name | Type | Description |
|-|-|-|
| None |   |   |
[Table 11. Parameters]

{#MGD-getNumericValue__table_MGD-getNumericValue_p} {#MGD-getNumericValue__table_MGD-getNumericValue_r__entry__2}

| Type | Description |
|-|-|
| Number | Number of milliseconds between January 1, 1970, 00:00:00 GMT and the start of the date value. Unit: Milliseconds |
[Table 12. Returns]

{#MGD-getNumericValue__table_MGD-getNumericValue_r}  
This example gets the current date and logs it as the number of milliseconds since January 1, 1970, 00:00:00 GMT.

    mgs.info(mgs.nowGlideDateTime().getDate().getNumericValue());

Output:

    1787788800000

## MobileGlideDate - getValue() {#ariaid-title8}

Gets the date value in the internal date format, yyyy-MM-dd, in the system time zone. Use this method for dates that you store or compare.
{#MGD-getValue__table_MGD-getValue_p__entry__3}

| Name | Type | Description |
|-|-|-|
| None |   |   |
[Table 13. Parameters]

{#MGD-getValue__table_MGD-getValue_p} {#MGD-getValue__table_MGD-getValue_r__entry__2}

| Type | Description |
|-|-|
| String | Date value in the yyyy-MM-dd format, such as 2026-08-26. The format doesn't change with the user's date format preference, so you can use it to store dates or compare them. |
[Table 14. Returns]

{#MGD-getValue__table_MGD-getValue_r}  
This example gets the current date and logs it in the internal format, `yyyy-MM-dd`, in the system time zone.

    mgs.info(mgs.nowGlideDateTime().getDate().getValue());

Output:

    "2026-08-26"

This example checks whether the current date is a blackout date. A button condition can use this check to hide a Schedule visit button on company holidays. Compare values in internal format because display formats vary by user.

    var blackoutDates = ['2026-11-26', '2026-12-25'];
            var today = mgs.nowGlideDateTime().getDate().getValue();
            var isBlackout = blackoutDates.indexOf(today) !== -1;
            mgs.info('Today is a blackout date: ' + isBlackout);

Output:

    Today is a blackout date: false

## MobileGlideDate - getYearNoTZ() {#ariaid-title9}

Gets the four-digit year from the date value, without converting the date to the user's or system time zone.
{#MGD-getYearNoTZ__table_MGD-getYearNoTZ_p__entry__3}

| Name | Type | Description |
|-|-|-|
| None |   |   |
[Table 15. Parameters]

{#MGD-getYearNoTZ__table_MGD-getYearNoTZ_p} {#MGD-getYearNoTZ__table_MGD-getYearNoTZ_r__entry__2}

| Type | Description |
|-|-|
| Number | Four-digit year of the date value, such as 2026. |
[Table 16. Returns]

{#MGD-getYearNoTZ__table_MGD-getYearNoTZ_r}  
This example gets the current date and logs the four-digit year, without adjusting for time zone.

    mgs.info(mgs.nowGlideDateTime().getDate().getYearNoTZ());

Output:

    2026

This example works out the fiscal year for an organization whose fiscal year starts in July. A write-back action can use the result to set a fiscal year field.

    var date = mgs.nowGlideDateTime().getDate();
            var year = date.getYearNoTZ();
            var fiscalYear = date.getMonthNoTZ() >= 7 ? year + 1 : year;
            mgs.info('FY' + fiscalYear);

Output:

    FY2027

## MobileGlideDate - isValid() {#ariaid-title10}

Determines whether the MobileGlideDate object contains a valid date. Use this method to check a date before you format or compare it.
{#MGD-isValid__table_MGD-isValid_p__entry__3}

| Name | Type | Description |
|-|-|-|
| None |   |   |
[Table 17. Parameters]

{#MGD-isValid__table_MGD-isValid_p} {#MGD-isValid__table_MGD-isValid_r__entry__2}

| Type | Description |
|-|-|
| Boolean | Flag that indicates whether the object contains a valid date. Possible values: * true: This is a valid date. * false: The object is empty or is not a valid date. {#MGD-isValid__ul_vkb_bvk_1lc} |
[Table 18. Returns]

{#MGD-isValid__table_MGD-isValid_r}  
This example gets the current date and logs whether it is a valid date.

    mgs.info(mgs.nowGlideDateTime().getDate().isValid());

Output:

    true

This example checks that a date is valid before the script formats it. Use this check when the date comes from a record field that might be empty or malformed.

    var date = mgs.nowGlideDateTime().getDate();
            if (date.isValid()) {
            mgs.info('Scheduled for ' + date.getDisplayValue());
            } else {
            mgs.info('No valid date. Skipping.');
            }

Output:

    Scheduled for 08/26/2026