Skip to main content

Defines sets and intervals to work with time, and provides arithmetic operations for them. Uses Cython extensions for performance.

Project description

Build Status Coverage Status PyPI version PyPI pyversions

PyTimeSet

Library that defines time intervals and sets and offers typical operations between them using Cython for speed.

Installation

Requirements: Python 3.6+

To install, simply run

pip install pytimeset

Basic Usage:

This library defines two immutable, timezone-aware, objects: TimeInterval and TimeSet.

Time intervals are defined by their start and end moments. Intervals are defined to contain their start point, but not their end point (closed to the left, open to the right).

Time sets are defined by the minimum set of intervals that contains all the points in it. This means that the intervals passed to the constructor of the TimeSet may not be the same intervals contained inside it, as "touching" intervals are merged and empty intervals are removed.

from datetime import datetime
from timeset import TimeInterval, TimeSet

t0 = datetime(2019, 7, 19)
t1 = datetime(2019, 7, 20)
t2 = datetime(2019, 7, 21)
t3 = datetime(2019, 7, 22)
t4 = datetime(2019, 7, 23)

empty = TimeInterval(t0, t0)
i0 = TimeInterval(t0, t2)
i1 = TimeInterval(t1, t3)
i2 = TimeInterval(t3, t4)
i3 = TimeInterval(t0, t4)

i0.contains(t1)  # True
i0.start == t0  # True
i0.end == t2  # True

i0.overlaps_with(i1)  # True
i0.is_subset(i3)  # True
empty.is_subset(i2)  # True, the empty set is subset of every other set.

i0.intersection(i1)  # TimeInterval(t1, t2)

Undefined behavior

Intervals defined by a single point (Such as TimeInterval(t, t)) are a bit weird. As of now, I have defined them to be equivalent to the empty set, but that might change in the future, so just don't mess too much with them.

This library is timezone-aware, meaning that you can pass timezone-aware datetimes to it and you will get back datetimes in the same timezone. That said, if you mix timezones, the results will point to the right moment in time, but their timezones are undefined (meaning any one of those you originally passed). When in doubt, simply convert the results to your preferred timezone.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pytimeset, version 0.6.2
Filename, size File type Python version Upload date Hashes
Filename, size pytimeset-0.6.2.tar.gz (58.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page