TimeFrames.jl

Time buckets for Julia

Group and resample dates and datetimes with explicit bucket boundaries.

Usage guide View on GitHub

🕒

Periods and frequencies

Construct frames from Dates periods or concise frequency strings.

📅

Calendar boundaries

Group by month, year, week, or subday intervals.

🧪

Supported and tested

Supports Julia 1.10 LTS and Julia 1.13 with tested examples.

TimeFrames defines time buckets for grouping and resampling Julia time values. It uses the Dates standard library and supports Julia 1.10 and later.

Installation

using Pkg
Pkg.add("TimeFrames")

Version 0.8.0 is registered in General and published as a GitHub release. To install that exact release for reproducibility:

using Pkg
Pkg.add(name="TimeFrames", version="0.8.0")

For local development, use Pkg.develop(path="/path/to/TimeFrames.jl"). Record the commit hash when testing an unreleased repository revision.

Development documentation

These pages follow main and include unreleased additions. The ms correction, colon ranges, weekly anchors, business months, inclusive calendar ranges, and submillisecond frames are intended for the next compatibility series, 0.9. They are not included in v0.8.0.

Quick start

julia> using Dates, TimeFrames

julia> apply(tf"5T", DateTime(2024, 1, 1, 12, 9))
2024-01-01T12:05:00

julia> Date(2024, 1, 1) + TimeFrame(Dates.Hour(2))
2024-01-01T02:00:00

See Usage, Migration, and API reference for supported frequencies, boundary behavior, and upgrade instructions.

Documentation builds also produce llms.txt and llms-full.txt alongside HTML.

Assisted-by: AI