{"id":13411516,"url":"https://github.com/ktowen/django_partial_date","last_synced_at":"2025-04-14T01:32:33.991Z","repository":{"id":25903874,"uuid":"106856553","full_name":"ktowen/django_partial_date","owner":"ktowen","description":"Django custom model field for partial dates with the form YYYY, YYYY-MM, YYYY-MM-DD","archived":false,"fork":false,"pushed_at":"2022-01-20T20:13:54.000Z","size":22,"stargazers_count":23,"open_issues_count":4,"forks_count":8,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-09-30T22:11:43.692Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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/ktowen.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-10-13T17:55:55.000Z","updated_at":"2024-05-13T09:04:16.000Z","dependencies_parsed_at":"2022-08-07T11:16:08.891Z","dependency_job_id":null,"html_url":"https://github.com/ktowen/django_partial_date","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ktowen%2Fdjango_partial_date","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ktowen%2Fdjango_partial_date/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ktowen%2Fdjango_partial_date/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ktowen%2Fdjango_partial_date/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ktowen","download_url":"https://codeload.github.com/ktowen/django_partial_date/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248807942,"owners_count":21164760,"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","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":[],"created_at":"2024-07-30T20:01:14.182Z","updated_at":"2025-04-14T01:32:33.956Z","avatar_url":"https://github.com/ktowen.png","language":"Python","funding_links":[],"categories":["Web Development"],"sub_categories":["Python"],"readme":"django_partial_date\n================\n\nDjango custom model field for partial dates with the form YYYY, YYYY-MM, YYYY-MM-DD\n\n * Works with DRF\n * Supports comparison operations\n * Supports Django 2.0 and Django 3.0\n\nUsage\n================\n\ninstall the package\n\n```bash\npip install django_partial_date\n```\n\n\n## partial_date.PartialDateField\n\nA django model field for storing partial dates. Accepts None, a partial_date.PartialDate object, or a formatted string such as YYYY, YYYY-MM, YYYY-MM-DD. In the database it saves the date in a column of type DateTimeField and uses the seconds to save the level of precision.\n\n## class partial_date.PartialDate\n\nObject to represent the partial dates.\n\n## Example\n\nmodels.py\n```python\nfrom django.db import models\nfrom partial_date import PartialDateField\n\nclass TestModel(models.Model):\n    some_partial_date = PartialDateField()\n```\n\n```python\n\u003e\u003e\u003e from partial_date import PartialDate\n\u003e\u003e\u003e from core.models import TestModel\n\u003e\u003e\u003e obj = TestModel(some_partial_date=\"1995\")\n\u003e\u003e\u003e obj.save()\n\u003e\u003e\u003e obj.some_partial_date\n'1995'\n\u003e\u003e\u003e obj.some_partial_date = PartialDate(\"1995-09\")\n\u003e\u003e\u003e obj.save()\n\u003e\u003e\u003e obj.some_partial_date\n1995-09\n\u003e\u003e\u003e\n```\n\n```python\n\u003e\u003e\u003e from partial_date import PartialDate\n\u003e\u003e\u003e import datetime\n\u003e\u003e\u003e partial_date_instance = PartialDate(datetime.date(2012, 9, 21), precision=PartialDate.DAY)\n\u003e\u003e\u003e partial_date_instance\n2012-09-21\n\u003e\u003e\u003e partial_date_instance.precisionYear()\nFalse\n\u003e\u003e\u003e partial_date_instance.precisionMonth()\nFalse\n\u003e\u003e\u003e partial_date_instance.precisionDay()\nTrue\n\u003e\u003e\u003e partial_date_instance.precision == PartialDate.YEAR\nFalse\n\u003e\u003e\u003e partial_date_instance.precision == PartialDate.MONTH\nFalse\n\u003e\u003e\u003e partial_date_instance.precision == PartialDate.DAY\nTrue\n\u003e\u003e\u003e partial_date_instance.precision = PartialDate.MONTH\n\u003e\u003e\u003e partial_date_instance\n2012-09\n\u003e\u003e\u003e partial_date_instance = PartialDate(\"2015-11-01\")\n\u003e\u003e\u003e partial_date_instance.date\ndatetime.date(2015, 11, 1)\n```\n\n\n```python\n\u003e\u003e\u003e from partial_date import PartialDate\n\u003e\u003e\u003e partial_date_instance = PartialDate(\"2015-11-01\")\n\u003e\u003e\u003e partial_date_instance\n2015-11-01\n\u003e\u003e\u003e partial_date_instance.format('%Y', '%m/%Y', '%m/%d/%Y') # .format(precision_year, precision_month, precision_day)\n'11/01/2015'\n\u003e\u003e\u003e partial_date_instance = PartialDate(\"2015-11\")\n\u003e\u003e\u003e partial_date_instance\n2015-11\n\u003e\u003e\u003e partial_date_instance.format('%Y', '%m/%Y', '%m/%d/%Y')\n'11/2015'\n\u003e\u003e\u003e partial_date_instance = PartialDate(\"2015\")\n\u003e\u003e\u003e partial_date_instance\n2015\n\u003e\u003e\u003e partial_date_instance.format('%Y', '%m/%Y', '%m/%d/%Y')\n'2015'\n```\n\nThanks for their collaborations to\n- lorinkoz\n- howieweiner\n- jghyllebert\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fktowen%2Fdjango_partial_date","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fktowen%2Fdjango_partial_date","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fktowen%2Fdjango_partial_date/lists"}