Source: https://docs.tracked.gg/conventions/data

# Dates, units, and missing data

State the period, timezone, units, and data coverage whenever they affect a result.

## Dates and timezones

A calendar date and an instant are different types of information. Use the member's or workflow's explicit timezone when interpreting today, Monday, or a reporting period.

Do not let the server's UTC timezone silently redefine a member's day. Show the resolved dates when acting on a relative date.

Week boundaries can depend on the member's settings. Preserve the tool's stated period instead of rebuilding a week with a library default.

## Units

Use the units returned by the tool or the member's explicit preference. Bodyweight can have a preference separate from training weight.

Label kilograms or pounds, energy, nutrient grams, distances, and durations as appropriate. Preserve the reported effort scale, such as RIR or RPE, instead of silently converting it.

## Coverage and unavailable values

- No rows means no records were returned for that scope and period; it does not establish that no real-world activity occurred.
- A null metric is unavailable, not zero.
- A missing domain or tool is not an empty dataset.
- A permission error is not a result for another account.
- A trend based on a few logged days should state that coverage.

Use a tool's supplied averages, denominators, and comparison periods when available. Do not blend periods or compare incompatible units.

## Connector periods

External connector tools have explicit bounds. An overlong window is rejected; it should not be silently shortened and presented as the requested period.

For supported comparisons, use the tool's previous-period option and report both periods' coverage. Read the live schema for the allowed arguments and limits.

## Offline and server state

Mobile changes may exist locally before they sync. Server-side tools cannot establish the contents of an unsynced device. State the response's freshness information when available and avoid describing server absence as deletion.

## Identifiers and ownership

Use resource identifiers returned by the authorized tool. Names are not unique identifiers. A public URL or shared program does not authorize access to its creator's private account data.

See [capabilities and access](/reference/capabilities).