---
sourceDocument: Xanadu Platform Analytics
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/xanadu/now-intelligence

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu 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: Xanadu
* 
* Updated August 1, 2024
* 
* ![](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, constructed by taking the timestamp of the last collection
period (`score_start`), extracting the year and the month from the timestamp, and appending the numeral 01 for the day. The toDate parameter is the timestamp of the beginning of the last collection period, which
would be the first second of the previous day, depending on timezone differences.

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

**Related concepts**   

* [PAFormulaUtils API](https://servicenow-prod.fluidtopics.net/jW9tCQXaNoAGNn13PQ5tkg "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://servicenow-prod.fluidtopics.net/rkfVEQmujlgYPjenHH6xjg "Returns the percentage of change in the score of an indicator between two specified dates.")
* [getCurrentAggregateID()](https://servicenow-prod.fluidtopics.net/AFISri81HvylNEj11KUNew "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://servicenow-prod.fluidtopics.net/QSWdIIrf5yFaMxnhWNrrqg "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://servicenow-prod.fluidtopics.net/AJudusXKGYHXVd3ntD3t1Q "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://servicenow-prod.fluidtopics.net/C546iFba6DSSFqAsBL62ng "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://servicenow-prod.fluidtopics.net/yr0R44XQQxV7CPoYA5lZgg "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://servicenow-prod.fluidtopics.net/2eKBthYMN2ebh4rPabxQHg "Returns the global target gap for the specified indicator on the specified date.")
* [getGlobalTarget(String indicator, Object onDate)](https://servicenow-prod.fluidtopics.net/kFixc5RvzpGlLY0AwQhV1Q "Returns the global target associated with the specified indicator for the specified date.")
* [getPersonalTarget(String indicator, Object onDate)](https://servicenow-prod.fluidtopics.net/pc9WOjWFfVXq4CA40IK~cQ "Returns the personal target associated with the specified indicator for the specified date.")
* [getScore(String indicator, Object onDate)](https://servicenow-prod.fluidtopics.net/xzipk~lohUNIGyymEUXtaA "Returns the score of the specified indicator for the specified date.")