More Time! Time as a vector space, the way it was meant to be.
Assume time forms an algebraic field over GMT. Finally!
Date is a simplified class for time manipulation. This library is intended for personal and business applications where assuming every solar day has 24 * 60 * 60 seconds is considered accurate. See GMT vs UTC below.
- All time is in GMT - Timezone math is left to be resolved at the human endpoints: Machines should only be dealing with one type of time; without holes, without overlap, and with minimal context.
- Single time type - There is no distinction between dates, datetime and times; all measurements in the time dimension are handled by one type called
Date. This is important for treating time as a vector space.
- Standard range comparision - All time range comparisons have been standardized to
min <= value < max. The minimum is inclusive (
<=), and the maximum is exclusive (
Date() method will convert unix timestamps, millisecond timestamps, various string formats and simple time formulas to create a GMT time
Date instance with millisecond resolution (in GMT).
Return end-of-day: Smallest
Date which is greater than all time points in today. Think of it as tomorrow. Same as
The beginning of today. Same as
Date.range(min, max, interval)
Return an explicit list of
Dates starting with
interval more than the last, but now including
max. Used in defining partitions in time domains.
This method is usually used to perform date comparisons at the given resolution (aka
duration). Round down to the nearest whole duration.
duration as assumed to be
DAY if not provided.
Number of milliseconds since epoch
Number of seconds since epoch
duration to the time to get a new
Date instance. The
self is not modified.
Convenience method for
Represents the difference between two
Dates. There are two scales:
DAYscale - includes seconds, minutes, hours, days and weeks.
YEARscale - includes months, quarters, years, and centuries.
Round down to nearest
return total number of seconds (including partial) in this duration (estimate given for
Same as the
Return number of given
interval rounded to given
Return a string representing
self using given
Time as an algebraic field
Duration objects are the point and vectors in a one dimensional vector space. As such, the
- operators are allowed. Comparisons with (
<) are also supported.
GMT vs UTC
The solar day is he most popular timekeeping unit. This library chose GMT (UT1) for its base clock because of its consistent seconds in a solar day. UTC suffers from inconsistent leap seconds and makes time-math difficult, even while forcing us to make pedantic conclusions like some minutes do not have 60 seconds. Lucky for us Python's implementation of UTC (
datetime.utcnow()) is wrong, and implements GMT: Which is what we use.
Assuming we need a generous leap second each 6 months (the past decade saw only 4 leap seconds), then GMT deviates from UTC by up to 1 seconds over 181 days (December to June, 15,638,400 seconds) which is an error rate
error = 1/15,638,400 = 0.000006395%. If we want to call the error "noise", we have a 70dB signal/noise ratio. All applications that can tolerate this level of error should use GMT as their time basis.
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.