---
sourceDocument: Australia Platform Analytics
sourceDocumentLink: https://www.servicenow.com/docs/r/now-intelligence

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Platform Analytics

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# getChange(String indicator, Object fromDate, Object toDate)

# getChange(String indicator, Object fromDate, Object toDate) {#ariaid-title1}

Release version: Australia  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
Returns the change in the score of an indicator between two specified
dates.
{#PAFU-getChange_S_O_O__table_y5l_dlm_mfb__entry__3}

| Name | Type | Description |
|-|-|-|
| indicator | String | Unique identifier of the indicator for which to calculate the change. |
| fromDate | Object | Initial date of the comparison. |
| toDate | Object | End date of the comparison. |
[Table 1. Parameters]

{#PAFU-getChange_S_O_O__table_y5l_dlm_mfb} {#PAFU-getChange_S_O_O__table_z5l_dlm_mfb__entry__2}

| Type | Description |
|-|-|
| Number | Difference in the specified indicator score between the two dates. |
[Table 2. Returns]

{#PAFU-getChange_S_O_O__table_z5l_dlm_mfb}  

## Change from the beginning of the month to the last collection period

In this example, we have the indicator Number of open incidents, whose scores are collected daily. The fromDate parameter is the first second of the current month. This value is constructed as follows:

1. The system takes the timestamp of the last collection period (`score_start`).
2. It extracts the year and the month from the timestamp.
3. It appends the numeral 01 for the day.
{#PAFU-getChange_S_O_O__ol_if4_jq1_lkc}

The toDate parameter is the timestamp of the beginning of the last collection period. This timestamp is the first second of the previous day, depending on time zone differences.

    pa.getChange($[[Number of open incidents]], new GlideDateTime(score_start.getYear() + '-' + score_start.getMonth() + '-01'), score_start);

**Related concepts**   

* [PAFormulaUtils API](https://www.servicenow.com/docs/99D37hCfkAbh~ZRie3Vnww "The PAFormulaUtils API enables you to obtain a value that was calculated in the Analytics Hub and use that value as input for a formula.")  
**Related reference**   

* [getChangePercentage(String indicator, Object fromDate, Object toDate)](https://www.servicenow.com/docs/Hz2OhobN3M4aGD24pjka1g "Returns the percentage of change in the score of an indicator between two specified dates.")
* [getCurrentAggregateID()](https://www.servicenow.com/docs/IHceZU0bUginX~fOzErEnA "Returns the time series aggregate identifier (sys_id) from the indicator of the current formula. The sys_id is returned dynamically, as the selection in the Analytics Hub changes.")
* [getCurrentBreakdownID()](https://www.servicenow.com/docs/KZtIj3cPvQh1x~h5HkjxHQ "Returns the level 1 breakdown identifier (sys_id) from the indicator of the current formula. The sys_id is returned dynamically, as the selection in the Analytics Hub changes.")
* [getCurrentBreakdownLevel2ID()](https://www.servicenow.com/docs/M9BKWSYujYPJ7TQOsO8GCQ "Returns the level 2 breakdown identifier (sys_id) from the indicator of the current formula. The sys_id is returned dynamically, as the selection in the Analytics Hub changes.")
* [getCurrentElementID()](https://www.servicenow.com/docs/bn7XgAMeyFpfnAqCrTzw6A "Returns the level 1 breakdown element identifier (sys_id) from the indicator of the current formula. The sys_id is returned dynamically, as the selection in the Analytics Hub changes.")
* [getCurrentElementLevel2ID()](https://www.servicenow.com/docs/3CoVDS0vKYlZqoQxt~~LGQ "Returns the level 2 breakdown element identifier (sys_id) from the indicator of the current formula. The sys_id is returned dynamically, as the selection in the Analytics Hub changes.")
* [getGap(String indicator, Object onDate)](https://www.servicenow.com/docs/Am7dVw2oGyafZF5NLB_xOA "Returns the global target gap for the specified indicator on the specified date.")
* [getGlobalTarget(String indicator, Object onDate)](https://www.servicenow.com/docs/Wevo2PZrwv3aOU1hUTXdAw "Returns the global target associated with the specified indicator for the specified date.")
* [getPersonalTarget(String indicator, Object onDate)](https://www.servicenow.com/docs/hQjj1zWy0Ykl4Z8dWQOomQ "Returns the personal target associated with the specified indicator for the specified date.")
* [getScore(String indicator, Object onDate)](https://www.servicenow.com/docs/wLp5ZYz56SS1VGrHSIf6pw "Returns the score of the specified indicator for the specified date.")