{"id":17645632,"url":"https://github.com/gtkacz/temporal_adjusters_py","last_synced_at":"2025-09-23T04:28:04.179Z","repository":{"id":244244281,"uuid":"814630089","full_name":"gtkacz/temporal_adjusters_py","owner":"gtkacz","description":"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.","archived":false,"fork":false,"pushed_at":"2025-09-08T03:11:13.000Z","size":179,"stargazers_count":5,"open_issues_count":17,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-20T18:40:14.290Z","etag":null,"topics":["date","datetime","package","python","temporal","time"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/temporal-adjuster/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gtkacz.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-06-13T11:38:34.000Z","updated_at":"2025-09-03T11:21:13.000Z","dependencies_parsed_at":"2024-12-09T18:18:57.931Z","dependency_job_id":"5ba548fc-1243-47e4-9b8a-d777df00e7d6","html_url":"https://github.com/gtkacz/temporal_adjusters_py","commit_stats":{"total_commits":41,"total_committers":4,"mean_commits":10.25,"dds":"0.41463414634146345","last_synced_commit":"27e9eff4785c824c3631ac649a5178afe0052e41"},"previous_names":["gtkacz/temporal_adjusters_py"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/gtkacz/temporal_adjusters_py","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gtkacz%2Ftemporal_adjusters_py","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gtkacz%2Ftemporal_adjusters_py/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gtkacz%2Ftemporal_adjusters_py/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gtkacz%2Ftemporal_adjusters_py/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gtkacz","download_url":"https://codeload.github.com/gtkacz/temporal_adjusters_py/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gtkacz%2Ftemporal_adjusters_py/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276243825,"owners_count":25609217,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-21T02:00:07.055Z","response_time":72,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["date","datetime","package","python","temporal","time"],"created_at":"2024-10-23T10:58:01.376Z","updated_at":"2025-09-23T04:28:04.130Z","avatar_url":"https://github.com/gtkacz.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ccenter\u003e\n\n# Temporal Adjuster\n\n\u003cp align=\"center\"\u003e\n\nAdjusters 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.\n\n\u003c/p\u003e\n\n[![PyPI status](https://img.shields.io/pypi/status/temporal-adjuster.svg)](https://pypi.python.org/pypi/temporal-adjuster/)\n[![Package Version](https://shields.io/pypi/v/temporal_adjuster)](https://pypi.org/project/temporal_adjuster/)\n[![Supported Python Versions](https://img.shields.io/pypi/pyversions/temporal-adjuster)](https://pypi.org/project/temporal-adjuster/)\n[![Downloads Per Month](https://shields.io/pypi/dm/temporal_adjuster)](https://pypistats.org/packages/temporal_adjuster)\n![Libraries.io dependency status for Github repo](https://img.shields.io/librariesio/github/gtkacz/temporal_adjusters_py)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)\n\n[![CI](https://github.com/gtkacz/temporal_adjusters_py/actions/workflows/CI.yml/badge.svg?branch=main)](https://github.com/gtkacz/temporal_adjusters_py/actions/workflows/CI.yml)\n[![codecov](https://codecov.io/github/gtkacz/temporal_adjusters_py/graph/badge.svg?token=WFJE0GHSZM)](https://codecov.io/github/gtkacz/temporal_adjusters_py)\n[![Documentation Status](https://readthedocs.org/projects/temporal-adjusters-py/badge/?version=latest)](http://temporal-adjusters-py.readthedocs.io/?badge=latest)\n[![Github commits](https://badgen.net/github/commits/gtkacz/temporal_adjusters_py)](https://Github.com/gtkacz/temporal_adjusters_py/commit/)\n[![Github latest commit](https://badgen.net/github/last-commit/gtkacz/temporal_adjusters_py)](https://Github.com/gtkacz/temporal_adjusters_py/commit/)\n![Github code size in bytes](https://img.shields.io/github/languages/code-size/gtkacz/temporal_adjusters_py)\n![Github repo file or directory count](https://img.shields.io/github/directory-file-count/gtkacz/temporal_adjusters_py)\n\n[![Github stars](https://badgen.net/github/stars/gtkacz/temporal_adjusters_py)](https://Github.com/gtkacz/temporal_adjusters_py/stargazers/)\n[![Github watchers](https://badgen.net/github/watchers/gtkacz/temporal_adjusters_py/)](https://Github.com/gtkacz/temporal_adjusters_py/watchers/)\n[![Github issues](https://img.shields.io/github/issues/gtkacz/temporal_adjusters_py.svg)](https://Github.com/gtkacz/temporal_adjusters_py/issues/)\n[![Github issues-closed](https://img.shields.io/github/issues-closed/gtkacz/temporal_adjusters_py.svg)](https://Github.com/gtkacz/temporal_adjusters_py/issues?q=is%3Aissue+is%3Aclosed)\n[![Average time to resolve an issue](http://isitmaintained.com/badge/resolution/gtkacz/temporal_adjusters_py.svg)](http://isitmaintained.com/project/gtkacz/temporal_adjusters_py \"Average time to resolve an issue\")\n[![Percentage of issues still open](http://isitmaintained.com/badge/open/gtkacz/temporal_adjusters_py.svg)](http://isitmaintained.com/project/gtkacz/temporal_adjusters_py \"Percentage of issues still open\")\n[![Github pull-requests](https://img.shields.io/github/issues-pr/gtkacz/temporal_adjusters_py.svg)](https://Github.com/gtkacz/temporal_adjusters_py/pull/)\n\u003c!-- [![Github contributors](https://img.shields.io/github/contributors/gtkacz/temporal_adjusters_py/badges.svg)](https://Github.com/gtkacz/temporal_adjusters_py/badges/graphs/contributors/) --\u003e\n\n\n\u003c/center\u003e\n\n## Installation\n\nYou can install Temporal Adjuster using pip:\n\n```sh\npip install temporal-adjuster\n```\n\n## Usage\n\nThis package provides a set of predefined temporal adjusters that can be used to adjust a temporal object in various ways. For example:\n\n```py\n\u003e\u003e\u003e from datetime import date, datetime\n\n\u003e\u003e\u003e from temporal_adjuster import TemporalAdjuster\n\u003e\u003e\u003e from temporal_adjuster.common.enums import Weekday\n\n\u003e\u003e\u003e TemporalAdjuster.first_day_of_next_week(date(2021, 1, 1))\ndatetime.date(2021, 1, 4)\n\n\u003e\u003e\u003e TemporalAdjuster.last_day_of_last_month(datetime(2021, 1, 1))\ndatetime.datetime(2020, 12, 31)\n\n\u003e\u003e\u003e TemporalAdjuster.first_of_year(Weekday.SATURDAY, date(2021, 1, 1))\ndatetime.date(2021, 1, 2)\n\n\u003e\u003e\u003e TemporalAdjuster.nth_of_month(Weekday.SUNDAY, datetime(2021, 5, 1), 2)\ndatetime.datetime(2021, 5, 9)\n\n\u003e\u003e\u003e TemporalAdjuster.next(Weekday.MONDAY, datetime(2021, 2, 11), 2)\ndatetime.datetime(2021, 2, 15)\n```\n\n## Contributing\n\nIf you have any suggestions or improvements for this package, feel free to submit a pull request or open an issue on the [GitHub repository](https://github.com/gtkacz/temporal_adjusters_py) as per the CONTRIBUTING document. We appreciate any feedback or contributions!\n\n\n\u003c!-- [![Stargazers over time](https://starchart.cc/gtkacz/temporal_adjusters_py.svg)](https://starchart.cc/gtkacz/temporal_adjusters_py)\n[![Contributors over time](https://contributor-graph-api.apiseven.com/contributors-svg?chart=contributorOverTime\u0026repo=gtkacz/temporal_adjusters_py)](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime\u0026repo=gtkacz/temporal_adjusters_py) --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgtkacz%2Ftemporal_adjusters_py","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgtkacz%2Ftemporal_adjusters_py","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgtkacz%2Ftemporal_adjusters_py/lists"}