---
title: "Timeseries"
description: "Timeseries datasets associate each data point with a specific timestamp, making them well suited for organizing and querying time-ordered observations."
image: "https://tilebox.com/images/tilebox-docs-social-preview.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://tilebox.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Timeseries

import ParamField from "@docs/components/ParamField.astro";

Each timeseries dataset comes with a set of required and auto-generated fields for each data point.

## Required fields

While the specific data fields between different time series datasets can vary, there are common fields that all time series datasets share.

**time**

type: Timestamp

The timestamp associated with each data point. Timestamps are always in UTC.

:::tip
  For indexing and querying, Tilebox truncates timestamps to millisecond precision. But Timeseries datasets may contain arbitrary custom `Timestamp` fields that store timestamps up to a nanosecond precision.
:::

## Auto-generated fields

**id**

type: UUID

A [universally unique identifier (UUID)](https://en.wikipedia.org/wiki/Universally_unique_identifier) that uniquely identifies each data point. IDs are generated so that sorting them lexicographically also sorts them by time.

:::tip
    IDs generated by Tilebox are deterministic, meaning that ingesting the exact same data values into the same collection will always result in the same ID.
:::

**ingestion_time**

type: Timestamp

The time the data point was ingested into the Tilebox API.

## Creating a timeseries dataset

To create a timeseries dataset, use the [Tilebox Console](/docs/console) and select `Timeseries Dataset` as the dataset type. The required and auto-generated fields
already outlined will be automatically added to the dataset schema.

## Time-based queries

Timeseries datasets support time-based queries. To query a specific time interval, specify a time range when [querying data](/docs/datasets/query/filter-by-time) from a dataset or a collection.

Source: https://tilebox.com/docs/datasets/types/timeseries/index.mdx