This documentation provides an overview of how timezones are handled in reports within our system. Understanding the timezone settings and conventions will ensure accurate data representation and consistent reporting across different features or reports.
Default Timezone
To ensure accurate timezone handling across the globe, we offer the following locales of Piano dashboards:
-
US dashboard (https://dashboard.piano.io/) - By default, all our servers operate in the Eastern Standard Time (EST) timezone, specifically "America/New_York"*
-
EU dashboard (https://dashboard-eu.piano.io/) - this server operates in Etc/UTC*
-
AP dashboard (https://dashboard-ap.piano.io/) - this server operates in the timezone UTC+9 (JST), specifically "Asia/Tokyo"*
-
AU dashboard (https://dashboard-au.piano.io/) - this server operates in the timezone GMT+10, specifically "Australia/Queensland"*
* if not specified otherwise under Edit Business.
App Timezone
Publishers have the option to specify a default timezone for their apps. This timezone is used for display purposes only, such as on the dashboard and in reports.
Here are some important considerations regarding the app timezone:
-
Display: The dashboard and reports should be displayed in the app timezone.
-
AngularResponse: AngularResponse should always include the display timezone. For publisher handlers, it will be the app timezone, while for other cases, it will be the timezone of the browser.
-
Date Range Pickers: Dates selected from the date range pickers will be provided as strings in the format "MM/dd/YYYY" (format configurable via the Localization dashboard).
Reports and Timezones
Different reports within our system may display dates and times based on various timezones. Here is an overview of how timezones are handled in specific reports:
-
Subscription Details Report: The dates in the Subscription Details report, accessible from the Piano dashboard, are based on the application's timezone. For example, if the application's timezone is set to Australia/Sydney, the report's data will be shown in GMT +11.
-
API Report: The timestamps in the API reports, accessed via the specified endpoints, are based on the EST timezone.
-
Mine Users Report: The dates in the Mine Users report should be displayed in the application's timezone.
-
Users' Profiles: Times displayed in users' profiles within the publisher dashboard are shown in the local time according to the system/browser timezone. Exported data, however, is displayed in the timezone of the respective application.