FORECAST.ETS.SEASONALITY function
FORECAST.ETS.SEASONALITY returns the length of the repeating pattern Excel detects in your data, such as 12 for monthly data with a yearly cycle. It returns 0 if no pattern is found.
Example
Excel shows 4
AE
AF
1
=DATE(2023,1,1)
=100+10*MOD(1-1,4)+1
2
=DATE(2023,2,1)
=100+10*MOD(2-1,4)+2
3
=DATE(2023,3,1)
=100+10*MOD(3-1,4)+3
4
=DATE(2023,4,1)
=100+10*MOD(4-1,4)+4
5
=DATE(2023,5,1)
=100+10*MOD(5-1,4)+5
6
=DATE(2023,6,1)
=100+10*MOD(6-1,4)+6
7
=DATE(2023,7,1)
=100+10*MOD(7-1,4)+7
8
=DATE(2023,8,1)
=100+10*MOD(8-1,4)+8
9
=DATE(2023,9,1)
=100+10*MOD(9-1,4)+9
10
=DATE(2023,10,1)
=100+10*MOD(10-1,4)+10
11
=DATE(2023,11,1)
=100+10*MOD(11-1,4)+11
12
=DATE(2023,12,1)
=100+10*MOD(12-1,4)+12
13
=DATE(2023,13,1)
=100+10*MOD(13-1,4)+13
14
=DATE(2023,14,1)
=100+10*MOD(14-1,4)+14
15
=DATE(2023,15,1)
=100+10*MOD(15-1,4)+15
16
=DATE(2023,16,1)
=100+10*MOD(16-1,4)+16
17
=DATE(2023,17,1)
=100+10*MOD(17-1,4)+17
18
=DATE(2023,18,1)
=100+10*MOD(18-1,4)+18
19
=DATE(2023,19,1)
=100+10*MOD(19-1,4)+19
20
=DATE(2023,20,1)
=100+10*MOD(20-1,4)+20
21
=DATE(2023,21,1)
=100+10*MOD(21-1,4)+21
22
=DATE(2023,22,1)
=100+10*MOD(22-1,4)+22
23
=DATE(2023,23,1)
=100+10*MOD(23-1,4)+23
24
=DATE(2023,24,1)
=100+10*MOD(24-1,4)+24
Data
Syntax
FORECAST.ETS.SEASONALITY(values, timeline, [data_completion], [aggregation])
Arguments in [square brackets] are optional.
-
values(required) - Historical values.
-
timeline(required) - Dates or numbers with a constant step.
-
data_completion(optional) - 1 interpolate (default), 0 zeros.
-
aggregation(optional) - How to merge duplicate timestamps.
Returns: The length of the repeating pattern Excel detects in the data.
What Excel actually returns
Each formula below was run in desktop Excel. The result is exactly what the cell showed, errors included.
| Formula | Excel shows | Case |
|---|---|---|
=FORECAST.ETS.SEASONALITY(Data!AF1:AF24,Data!AE1:AE24) | 4 | Detected period |
=FORECAST.ETS.SEASONALITY(Data!F1:F5,Data!F1:F5) | 0 | Linear data (no season) |
=FORECAST.ETS.SEASONALITY(Data!AH1:AH6,Data!AG1:AG6) | 0 | Duplicate timeline |
=FORECAST.ETS.SEASONALITY(Data!AH1:AH6,Data!AG1:AG6,1,2) | 0 | Aggregation 2 |
=FORECAST.ETS.SEASONALITY(Data!AF1:AF23,Data!AE1:AE24) | #N/A | Different sizes |
The Data sheet these formulas read
A cell that starts with = holds that formula.
F
AE
AF
AG
AH
1
1
=DATE(2023,1,1)
=100+10*MOD(1-1,4)+1
1
10
2
2
=DATE(2023,2,1)
=100+10*MOD(2-1,4)+2
2
20
3
3
=DATE(2023,3,1)
=100+10*MOD(3-1,4)+3
2
30
4
4
=DATE(2023,4,1)
=100+10*MOD(4-1,4)+4
4
40
5
5
=DATE(2023,5,1)
=100+10*MOD(5-1,4)+5
5
50
6
=DATE(2023,6,1)
=100+10*MOD(6-1,4)+6
6
60
7
=DATE(2023,7,1)
=100+10*MOD(7-1,4)+7
8
=DATE(2023,8,1)
=100+10*MOD(8-1,4)+8
9
=DATE(2023,9,1)
=100+10*MOD(9-1,4)+9
10
=DATE(2023,10,1)
=100+10*MOD(10-1,4)+10
11
=DATE(2023,11,1)
=100+10*MOD(11-1,4)+11
12
=DATE(2023,12,1)
=100+10*MOD(12-1,4)+12
13
=DATE(2023,13,1)
=100+10*MOD(13-1,4)+13
14
=DATE(2023,14,1)
=100+10*MOD(14-1,4)+14
15
=DATE(2023,15,1)
=100+10*MOD(15-1,4)+15
16
=DATE(2023,16,1)
=100+10*MOD(16-1,4)+16
17
=DATE(2023,17,1)
=100+10*MOD(17-1,4)+17
18
=DATE(2023,18,1)
=100+10*MOD(18-1,4)+18
19
=DATE(2023,19,1)
=100+10*MOD(19-1,4)+19
20
=DATE(2023,20,1)
=100+10*MOD(20-1,4)+20
21
=DATE(2023,21,1)
=100+10*MOD(21-1,4)+21
22
=DATE(2023,22,1)
=100+10*MOD(22-1,4)+22
23
=DATE(2023,23,1)
=100+10*MOD(23-1,4)+23
24
=DATE(2023,24,1)
=100+10*MOD(24-1,4)+24
Data
Watch out for
- Returns 0 when no seasonal pattern is found.
- Needs enough history to see the cycle.
Where it works
- Excel
- FORECAST.ETS.SEASONALITY arrived in Excel 2016. Older versions do not have it.
- Google Sheets
- No direct equivalent. No Sheets counterpart.
Part of Statistical functions. Every result on this page was measured in desktop Excel, build 16.0.20527. Last updated .