Skip to contents

Returns HICP inflation data for one or more euro area countries or country groups. The default is the euro area aggregate ("U2").

Usage

ecb_hicp(
  country = "U2",
  measure = c("annual_rate", "index", "monthly_rate"),
  from = NULL,
  to = NULL,
  cache = TRUE
)

Arguments

country

Character vector of country codes. Use "U2" for the euro area aggregate, or ISO 2-letter codes such as "DE" (Germany), "FR" (France), "IT" (Italy), "ES" (Spain).

measure

One of:

  • "annual_rate" (default) – year-on-year percentage change

  • "index" – index level (2015 = 100)

  • "monthly_rate" – month-on-month percentage change

from

Optional start date.

to

Optional end date.

cache

Logical. Use cached data if available (default TRUE).

Value

A data frame with columns:

date

Date.

country

Character. Country or area code.

value

Numeric. Inflation rate or index level.

Examples

# \donttest{
op <- options(readecb.cache_dir = tempdir())
ecb_hicp(from = "2020-01")
#>  Fetching HICP data
#>  Fetching HICP data [650ms]
#> 
#>          date country value
#> 1  2020-01-01      U2   1.4
#> 2  2020-02-01      U2   1.2
#> 3  2020-03-01      U2   0.7
#> 4  2020-04-01      U2   0.3
#> 5  2020-05-01      U2   0.1
#> 6  2020-06-01      U2   0.3
#> 7  2020-07-01      U2   0.4
#> 8  2020-08-01      U2  -0.2
#> 9  2020-09-01      U2  -0.3
#> 10 2020-10-01      U2  -0.3
#> 11 2020-11-01      U2  -0.3
#> 12 2020-12-01      U2  -0.3
#> 13 2021-01-01      U2   0.9
#> 14 2021-02-01      U2   0.9
#> 15 2021-03-01      U2   1.3
#> 16 2021-04-01      U2   1.6
#> 17 2021-05-01      U2   2.0
#> 18 2021-06-01      U2   1.9
#> 19 2021-07-01      U2   2.2
#> 20 2021-08-01      U2   3.0
#> 21 2021-09-01      U2   3.4
#> 22 2021-10-01      U2   4.1
#> 23 2021-11-01      U2   4.9
#> 24 2021-12-01      U2   5.0
#> 25 2022-01-01      U2   5.1
#> 26 2022-02-01      U2   5.9
#> 27 2022-03-01      U2   7.4
#> 28 2022-04-01      U2   7.4
#> 29 2022-05-01      U2   8.1
#> 30 2022-06-01      U2   8.6
#> 31 2022-07-01      U2   8.9
#> 32 2022-08-01      U2   9.1
#> 33 2022-09-01      U2   9.9
#> 34 2022-10-01      U2  10.6
#> 35 2022-11-01      U2  10.1
#> 36 2022-12-01      U2   9.2
#> 37 2023-01-01      U2   8.6
#> 38 2023-02-01      U2   8.5
#> 39 2023-03-01      U2   6.9
#> 40 2023-04-01      U2   7.0
#> 41 2023-05-01      U2   6.1
#> 42 2023-06-01      U2   5.5
#> 43 2023-07-01      U2   5.3
#> 44 2023-08-01      U2   5.2
#> 45 2023-09-01      U2   4.3
#> 46 2023-10-01      U2   2.9
#> 47 2023-11-01      U2   2.4
#> 48 2023-12-01      U2   2.9
#> 49 2024-01-01      U2   2.8
#> 50 2024-02-01      U2   2.6
#> 51 2024-03-01      U2   2.4
#> 52 2024-04-01      U2   2.4
#> 53 2024-05-01      U2   2.6
#> 54 2024-06-01      U2   2.5
#> 55 2024-07-01      U2   2.6
#> 56 2024-08-01      U2   2.2
#> 57 2024-09-01      U2   1.7
#> 58 2024-10-01      U2   2.0
#> 59 2024-11-01      U2   2.2
#> 60 2024-12-01      U2   2.4
#> 61 2025-01-01      U2   2.5
#> 62 2025-02-01      U2   2.3
#> 63 2025-03-01      U2   2.2
#> 64 2025-04-01      U2   2.2
#> 65 2025-05-01      U2   1.9
#> 66 2025-06-01      U2   2.0
#> 67 2025-07-01      U2   2.0
#> 68 2025-08-01      U2   2.0
#> 69 2025-09-01      U2   2.2
#> 70 2025-10-01      U2   2.1
#> 71 2025-11-01      U2   2.1
#> 72 2025-12-01      U2   1.9
ecb_hicp(c("DE", "FR", "IT"), from = "2023-01")
#>  Fetching HICP data
#>  Fetching HICP data [487ms]
#> 
#>           date country value
#> 1   2023-01-01      DE   9.2
#> 2   2023-02-01      DE   9.3
#> 3   2023-03-01      DE   7.8
#> 4   2023-04-01      DE   7.6
#> 5   2023-05-01      DE   6.3
#> 6   2023-06-01      DE   6.8
#> 7   2023-07-01      DE   6.5
#> 8   2023-08-01      DE   6.4
#> 9   2023-09-01      DE   4.3
#> 10  2023-10-01      DE   3.0
#> 11  2023-11-01      DE   2.3
#> 12  2023-12-01      DE   3.8
#> 13  2024-01-01      DE   3.1
#> 14  2024-02-01      DE   2.7
#> 15  2024-03-01      DE   2.3
#> 16  2024-04-01      DE   2.4
#> 17  2024-05-01      DE   2.8
#> 18  2024-06-01      DE   2.5
#> 19  2024-07-01      DE   2.6
#> 20  2024-08-01      DE   2.0
#> 21  2024-09-01      DE   1.8
#> 22  2024-10-01      DE   2.4
#> 23  2024-11-01      DE   2.4
#> 24  2024-12-01      DE   2.8
#> 25  2025-01-01      DE   2.8
#> 26  2025-02-01      DE   2.6
#> 27  2025-03-01      DE   2.3
#> 28  2025-04-01      DE   2.2
#> 29  2025-05-01      DE   2.1
#> 30  2025-06-01      DE   2.0
#> 31  2025-07-01      DE   1.8
#> 32  2025-08-01      DE   2.1
#> 33  2025-09-01      DE   2.4
#> 34  2025-10-01      DE   2.3
#> 35  2025-11-01      DE   2.6
#> 36  2025-12-01      DE   2.0
#> 37  2023-01-01      FR   7.0
#> 38  2023-02-01      FR   7.3
#> 39  2023-03-01      FR   6.7
#> 40  2023-04-01      FR   6.9
#> 41  2023-05-01      FR   6.0
#> 42  2023-06-01      FR   5.3
#> 43  2023-07-01      FR   5.1
#> 44  2023-08-01      FR   5.7
#> 45  2023-09-01      FR   5.7
#> 46  2023-10-01      FR   4.5
#> 47  2023-11-01      FR   3.9
#> 48  2023-12-01      FR   4.1
#> 49  2024-01-01      FR   3.4
#> 50  2024-02-01      FR   3.2
#> 51  2024-03-01      FR   2.4
#> 52  2024-04-01      FR   2.4
#> 53  2024-05-01      FR   2.6
#> 54  2024-06-01      FR   2.5
#> 55  2024-07-01      FR   2.7
#> 56  2024-08-01      FR   2.2
#> 57  2024-09-01      FR   1.4
#> 58  2024-10-01      FR   1.6
#> 59  2024-11-01      FR   1.7
#> 60  2024-12-01      FR   1.8
#> 61  2025-01-01      FR   1.8
#> 62  2025-02-01      FR   0.9
#> 63  2025-03-01      FR   0.9
#> 64  2025-04-01      FR   0.9
#> 65  2025-05-01      FR   0.6
#> 66  2025-06-01      FR   0.9
#> 67  2025-07-01      FR   0.9
#> 68  2025-08-01      FR   0.8
#> 69  2025-09-01      FR   1.1
#> 70  2025-10-01      FR   0.8
#> 71  2025-11-01      FR   0.8
#> 72  2025-12-01      FR   0.7
#> 73  2023-01-01      IT  10.7
#> 74  2023-02-01      IT   9.8
#> 75  2023-03-01      IT   8.1
#> 76  2023-04-01      IT   8.6
#> 77  2023-05-01      IT   8.0
#> 78  2023-06-01      IT   6.7
#> 79  2023-07-01      IT   6.3
#> 80  2023-08-01      IT   5.5
#> 81  2023-09-01      IT   5.6
#> 82  2023-10-01      IT   1.8
#> 83  2023-11-01      IT   0.6
#> 84  2023-12-01      IT   0.5
#> 85  2024-01-01      IT   0.9
#> 86  2024-02-01      IT   0.8
#> 87  2024-03-01      IT   1.2
#> 88  2024-04-01      IT   0.9
#> 89  2024-05-01      IT   0.8
#> 90  2024-06-01      IT   0.9
#> 91  2024-07-01      IT   1.6
#> 92  2024-08-01      IT   1.2
#> 93  2024-09-01      IT   0.7
#> 94  2024-10-01      IT   1.0
#> 95  2024-11-01      IT   1.5
#> 96  2024-12-01      IT   1.4
#> 97  2025-01-01      IT   1.7
#> 98  2025-02-01      IT   1.7
#> 99  2025-03-01      IT   2.1
#> 100 2025-04-01      IT   2.0
#> 101 2025-05-01      IT   1.7
#> 102 2025-06-01      IT   1.8
#> 103 2025-07-01      IT   1.7
#> 104 2025-08-01      IT   1.6
#> 105 2025-09-01      IT   1.8
#> 106 2025-10-01      IT   1.3
#> 107 2025-11-01      IT   1.1
#> 108 2025-12-01      IT   1.2
options(op)
# }