Skip to main content

Adjusters are a key tool for modifying temporal objects. They exist to externalize the process of adjustment, permitting different approaches, as per the strategy design pattern. Temporal Adjuster provides tools that help pinpoint very specific moments in time, without having to manually count days, weeks, or months.

Project description

Temporal Adjuster

Adjusters are a key tool for modifying temporal objects. They exist to externalize the process of adjustment, permitting different approaches, as per the strategy design pattern. Temporal Adjuster provides tools that help pinpoint very specific moments in time, without having to manually count days, weeks, or months. In essence, a Temporal Adjuster is a function that encapsulates a specific date/time manipulation rule. It operates on a temporal object (representing a date, time, or datetime) to produce a new temporal object adjusted according to the rule. Examples might be an adjuster that sets the date avoiding weekends, or one that sets the date to the last day of the month.

PyPI status Package Version Supported Python Versions Downloads Per Month Libraries.io dependency status for Github repo License: MIT

CI codecov Documentation Status Github commits Github latest commit Github code size in bytes Github repo file or directory count

Github stars Github watchers Github issues Github issues-closed Average time to resolve an issue Percentage of issues still open Github pull-requests

Installation

You can install Temporal Adjuster using pip:

pip install temporal-adjuster

Usage

This package provides a set of predefined temporal adjusters that can be used to adjust a temporal object in various ways. For example:

>>> from datetime import date, datetime

>>> from temporal_adjuster import TemporalAdjuster
>>> from temporal_adjuster.common.enums import Weekday

>>> TemporalAdjuster.first_day_of_next_week(date(2021, 1, 1))
datetime.date(2021, 1, 4)

>>> TemporalAdjuster.last_day_of_last_month(datetime(2021, 1, 1))
datetime.datetime(2020, 12, 31)

>>> TemporalAdjuster.first_of_year(Weekday.SATURDAY, date(2021, 1, 1))
datetime.date(2021, 1, 2)

>>> TemporalAdjuster.nth_of_month(Weekday.SUNDAY, datetime(2021, 5, 1), 2)
datetime.datetime(2021, 5, 9)

>>> TemporalAdjuster.next(Weekday.MONDAY, datetime(2021, 2, 11), 2)
datetime.datetime(2021, 2, 15)

Contributing

If you have any suggestions or improvements for this package, feel free to submit a pull request or open an issue on the GitHub repository as per the CONTRIBUTING document. We appreciate any feedback or contributions!

Project details


Download files

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

Source Distribution

temporal_adjuster-1.2.0.tar.gz (13.9 kB view details)

Uploaded Source

Built Distribution

temporal_adjuster-1.2.0-py3-none-any.whl (19.0 kB view details)

Uploaded Python 3

File details

Details for the file temporal_adjuster-1.2.0.tar.gz.

File metadata

  • Download URL: temporal_adjuster-1.2.0.tar.gz
  • Upload date:
  • Size: 13.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.0

File hashes

Hashes for temporal_adjuster-1.2.0.tar.gz
Algorithm Hash digest
SHA256 a2bfba810de8bc0140452844f92155ff47a29c877a6f027c4afa0985d538f6dd
MD5 e8622653c4b2d31f5340780e832a325c
BLAKE2b-256 b327a287e0d7547640e638b59741f016855e812c5f809bbf97786564026667d2

See more details on using hashes here.

File details

Details for the file temporal_adjuster-1.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for temporal_adjuster-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5e821c1a40dd591276d7884e6bc0a3333c14a020a7bd3fb85947477cc5d06b19
MD5 7f071db1759214bc5103d993a7db205a
BLAKE2b-256 80b7c7024e3cd2fe6924c2294c3afaf346ea0217bf738e787699704861169d95

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page