Skip to main content

How does DataDoe handle timezones?

Dates in columns with the DATE type (like date) are always in the marketplace's local timezone. The table below shows a mapping from marketplace to timezone.

If a date is stored with the DATETIME type, it is stored in UTC, which may be different from the marketplace’s local timezone and the user’s local timezone.

Which date columns should I use for order data?

The amazon_order_items_with_cogs table exposes three date-related columns. The table below shows which column to use for different use cases.

ColumnTypeMeaning
dateDATEDate of purchase in the marketplace's local timezone. See the table below for a mapping from marketplace to timezone.
order_dateDATEThis is a copy of the date column made for easier aggregation of orders with settlement tables. Prefer using the original date column.
order_purchased_at_utcDATETIMEDate and time of purchase in UTC.

You can check all column definitions in the Data Scheme.

What timezones does DataDoe use for each marketplace?

The table below shows the timezone used by DataDoe for each Amazon marketplace:

Amazon Marketplace CountryAmazon Marketplace IDDataDoe timezone
CanadaA2EUQ1WTGCTBG2America/Los_Angeles
United StatesATVPDKIKX0DERAmerica/Los_Angeles
MexicoA1AM78C64UM0Y8America/Mexico_City
BrazilA2Q3Y263D00KWCAmerica/Sao_Paulo
IrelandA28R8C7NBKEWEAEurope/Dublin
SpainA1RKKUPIHCS9HSEurope/Madrid
United KingdomA1F83G8C2ARO7PEurope/London
FranceA13V1IB3VIYZZHEurope/Paris
BelgiumAMEN7PMS3EDWLEurope/Brussels
NetherlandsA1805IZSGTT6HSEurope/Amsterdam
GermanyA1PA6795UKMFR9Europe/Berlin
ItalyAPJ6JRA9NG5V4Europe/Rome
SwedenA2NODRKZP88ZB9Europe/Stockholm
South AfricaAE08WJ6YKNBMCAfrica/Johannesburg
PolandA1C3SOZRARQ6R3Europe/Warsaw
EgyptARBP9OOSHTCHUAfrica/Cairo
TurkeyA33AVAJ2PDY3EVEurope/Istanbul
Saudi ArabiaA17E79C6D8DWNPAsia/Riyadh
United Arab EmiratesA2VIGQ35RCS4UGAsia/Dubai
IndiaA21TJRUUN4KGVAsia/Kolkata
SingaporeA19VAU5U5O7RUSAsia/Singapore
AustraliaA39IBJ37TRP1C6Australia/Sydney
JapanA1VC38T7YXB528Asia/Tokyo

Why do timezones matter?

An order with order_purchased_at_utc of 2026-05-01T06:30:00Z has a date of 2026-04-30 in the America/Los_Angeles (PDT) timezone but a date of 2026-05-01 in the America/New_York (EDT) timezone. Depending on the user’s location and geographic exposure, data may need to be normalized to a specific timezone.