Learn how to run queries for datapoints within a given temporal extent.
query
method depends on the exact temporal extent parameter you provide.
tuple
in the form (start, end)
as the temporal_extent
parameter. Both start
and end
must be TimeScalars, which can be datetime
objects or strings in ISO 8601 format.
show_progress
parameter is optional and can be used to display a tqdm progress bar while loading data.2025-06-01
includes data points up to 2025-05-31 23:59:59.999
, but excludes those from 2025-06-01 00:00:00.000
.
This behavior mimics the Python range
function and is useful for chaining time intervals.
TimeInterval
. This way you can specify both the start
and end
times, as well as their inclusivity. Here’s an example of creating equivalent TimeInterval
objects in two different ways.
TimeScalar
as the time query argument. A TimeScalar
can be a datetime
object or a string in ISO 8601 format.
TimeScalars
specified as a string are treated as UTC if they do not include a timezone suffix. If you want to query data for a specific time or time range
in another timezone, it’s recommended to a type that includes timezone information. Tilebox will automatically convert such objects to UTC
in order to send the right query requests.
All outputs will always contain UTC timestamps, which will need to be converted again to a different timezone if required.