Current Data Release Widget

Beta version

The new Calendar Widgets are still in beta and may be subject to some changes.

The Current Data Release Widget shows the two most recent data releases for a calendar event.

The widget shows the next data release (or occurrence) of the event and the previous one. It includes the date, time, actual, deviation and consensus for those two event occurrences. In addition, it incorporates a countdown for the next release and receives live updates immediately after the data is released.

In case the last occurrence happened within a configured margin, the widget will consider this occurrence as the current data release and it will show the current the previous release, not the the next one.

Parameters

To learn how to set widget parameters dynamically, please read this.

event-id

Required.

The recurrent event ID. It can be retrieved using the Economic Calendar API.

Examples

  • 5e5f6e2f-7e6f-404e-bd1a-456558f0de11 - Gross Domestic Product (MoM) - UK
  • 9cdf56fd-99e4-4026-aa99-2b6c0ca92811 - Nonfarm Payrolls - US

culture

Optional.

The language in which the widget should be displayed. The language codes can be found here.

Default: en (English)

timezone-offset

Optional.

Sets the timezone in which the dates and times should be displayed, represented as the time zone difference (in minutes), from the desired timezone to UTC. Please see a list of all timezones, here.

Default: 0 (Coordinated Universal Time - UTC+00:00)

caution

The time-zone offset is the difference, in minutes, from the desired time to UTC. Note that this means that the offset is positive if the local timezone is behind UTC and negative if it is ahead.

For example, for time zone UTC+10:00 (Australian Eastern Standard Time, Vladivostok Time, Chamorro Standard Time), -600 will be the correct parameter value.

Usage

<!-- UTC+01:00 -- Central European Time -->
timezone-offset="-60"
<!-- UTC-05:00 -- Central Daylight Time (North America) -->
timezone-offset="300"
<!-- User browser timezone -->
timezone-offset="new Date().getTimezoneOffset()"

margin-in-hours

Optional.

Defines the margin in hours that is used to consider when a data release is current. For instance, if margin-in-hours is 5 hours, then any data release happening today at 13:00h will be considered as the current release from today at 08:00h to today at 18:00h.

Default: 24