User Profile and Timezone Settings

This document explains how to configure your user profile and timezone settings in Dashboard.PT. Proper configuration ensures that all dates and times displayed in the application match your local timezone.

Profile Settings

Your profile contains personal information and display preferences that affect how you experience Dashboard.PT.

Setting Description
First Name * Your first name (required)
Last Name * Your last name (required)
Email * Your email address (required)
Company Your company or organization name
Phone Your contact phone number
Address Your physical address
Language Your preferred interface language (Portuguese or English)
Timezone Your local timezone for date and time display

How to Access Profile Settings

  1. Click on your avatar in the top-right corner of the screen
  2. Select "Profile" from the dropdown menu
  3. Update your information as needed
  4. Click "Save" to apply your changes

Timezone Settings

The timezone setting is particularly important as it affects how dates and times are displayed throughout the application. All timestamps are stored in UTC in the database but will be converted to your selected timezone for display.

Why Timezone Matters

Setting the correct timezone ensures that:

  • Your data points are displayed with the correct local time
  • Time-based analytics reflect your local business hours
  • Scheduled reports run at appropriate times for your region
  • Date filters work as expected in your local time context

Available Timezone Options

Timezone Description UTC Offset
Europe/Lisbon Lisbon, Portugal UTC+0/+1 (DST)
Atlantic/Azores Azores, Portugal UTC-1/+0 (DST)
Europe/London London, United Kingdom UTC+0/+1 (DST)
Europe/Paris Paris, Berlin, Rome, Madrid UTC+1/+2 (DST)
America/New_York New York, USA (Eastern Time) UTC-5/-4 (DST)
America/Sao_Paulo São Paulo, Brazil UTC-3
UTC Coordinated Universal Time UTC+0

Note: DST indicates that the region observes Daylight Saving Time.

How Timezone Affects Data Display

When you change your timezone setting, all timestamps displayed in the interface will automatically convert to show the correct time in your selected timezone. This affects:

  • Graph data timestamps
  • Dashboard update times
  • Data point creation and modification dates
  • Alert trigger timestamps
  • System logs and audit trails

Important Note

When adding or editing data points manually, the time you enter will be interpreted as being in your selected timezone. The system will automatically convert this to UTC for storage.

API and Timezones

When working with the API, it's important to understand how timezones are handled:

  • All timestamps sent to the API should be in ISO 8601 format (YYYY-MM-DD HH:MM:SS)
  • The API always interprets incoming timestamps as UTC unless explicitly specified
  • All timestamps returned by the API are in UTC
  • Client applications should convert timestamps to the user's local timezone for display

API Timestamp Example

Request body example for adding data points with timestamps:

{
  "graph_id": 123,
  "data": [
    {
      "timestamp": "2023-06-15T14:30:00Z", // The 'Z' indicates UTC time
      "value": 42.5,
      "label": "June Sales"
    },
    {
      "timestamp": "2023-07-15T14:30:00+01:00", // Explicitly specifying UTC+1
      "value": 47.8,
      "label": "July Sales"
    }
  ]
}

Troubleshooting Timezone Issues

Issue Possible Solution
Times are off by a few hours Check if your timezone setting matches your actual location
Data appears on wrong date This may occur when crossing day boundaries between timezones; verify your timezone setting
Times shifted by 1 hour after DST change The system automatically handles DST; this may be due to API submissions with explicit timestamps
API data and UI display different times Remember that API returns UTC times which need to be converted for display

For additional assistance with timezone configuration, please contact support@dashboard.pt.

Want to try it? The free plan has no time limit.

Create a free account