Skip to main content

How does DataDoe handle time zones?

Dates in columns with the DATE type, such as date, always use the marketplace's local time zone. The table below shows the time zone for each marketplace.

Dates stored with the DATETIME type use UTC. This may be different from the marketplace's local time zone and the user's local time zone.

Which date columns should I use for order data?

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

ColumnTypeMeaning
dateDATEPurchase date in the marketplace's local time zone. See the table below for the time zone used by each marketplace.
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 reference.

What time zones does DataDoe use for each marketplace?

The table below shows the time zone DataDoe uses for each Amazon marketplace.

Amazon marketplace countryAmazon marketplace IDDataDoe time zone
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 time zones matter?

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