{"id":21150856,"url":"https://github.com/cedargrovestudios/circuitpython_dst_adjuster","last_synced_at":"2025-08-23T14:37:47.505Z","repository":{"id":61958545,"uuid":"555194455","full_name":"CedarGroveStudios/CircuitPython_DST_Adjuster","owner":"CedarGroveStudios","description":"A CircuitPython helper to adjust to North American Daylight Saving Time (DST).","archived":false,"fork":false,"pushed_at":"2025-06-30T17:57:20.000Z","size":600,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-04T11:48:59.481Z","etag":null,"topics":["circuitpython","circuitpython-community-bundle","daylight-saving-time","helper","structured-time"],"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/CedarGroveStudios.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-21T05:38:53.000Z","updated_at":"2025-06-30T17:45:57.000Z","dependencies_parsed_at":"2024-11-20T10:56:29.964Z","dependency_job_id":"409fc73a-6849-48cc-9987-9688c7c1fc5a","html_url":"https://github.com/CedarGroveStudios/CircuitPython_DST_Adjuster","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/CedarGroveStudios/CircuitPython_DST_Adjuster","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CedarGroveStudios%2FCircuitPython_DST_Adjuster","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CedarGroveStudios%2FCircuitPython_DST_Adjuster/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CedarGroveStudios%2FCircuitPython_DST_Adjuster/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CedarGroveStudios%2FCircuitPython_DST_Adjuster/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CedarGroveStudios","download_url":"https://codeload.github.com/CedarGroveStudios/CircuitPython_DST_Adjuster/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CedarGroveStudios%2FCircuitPython_DST_Adjuster/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271752129,"owners_count":24814750,"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-08-23T02:00:09.327Z","response_time":69,"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":["circuitpython","circuitpython-community-bundle","daylight-saving-time","helper","structured-time"],"created_at":"2024-11-20T10:09:01.522Z","updated_at":"2025-08-23T14:37:47.164Z","avatar_url":"https://github.com/CedarGroveStudios.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Introduction\n============\n\n\n\n\n.. image:: https://img.shields.io/discord/327254708534116352.svg\n    :target: https://adafru.it/discord\n    :alt: Discord\n\n\n.. image:: https://github.com/CedarGroveStudios/CircuitPython_DST_Adjuster/workflows/Build%20CI/badge.svg\n    :target: https://github.com/CedarGroveStudios/CircuitPython_DST_Adjuster/actions\n    :alt: Build Status\n\n\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg\n    :target: https://github.com/psf/black\n    :alt: Code Style: Black\n\nA CircitPython helper to detect and adjust North American Daylight Saving Time (DST).\n\n``Adjust DST`` converts Standard Time (xST) to North American DST. Input to this\nfunction is a structured time object in xST. The function returns a structured\ntime object adjusted to a DST value if appropriate and a flag indicating the DST\nadjustment was made. The helper cannot detect DST for a structured time object\nthat is encoded as DST.\n\n.. image:: https://github.com/CedarGroveStudios/CircuitPython_DST_Adjuster/blob/main/media/WARNING.jpg\n\n\nDependencies\n=============\nThis driver depends on:\n\n* `Adafruit CircuitPython \u003chttps://github.com/adafruit/circuitpython\u003e`_\n\nPlease ensure all dependencies are available on the CircuitPython filesystem.\nThis is easily achieved by downloading\n`the Adafruit library and driver bundle \u003chttps://circuitpython.org/libraries\u003e`_\nor individual libraries can be installed using\n`circup \u003chttps://github.com/adafruit/circup\u003e`_.\n\nInstalling to a Connected CircuitPython Device with Circup\n==========================================================\n\nMake sure that you have ``circup`` installed in your Python environment.\nInstall it with the following command if necessary:\n\n.. code-block:: shell\n\n    pip3 install circup\n\nWith ``circup`` installed and your CircuitPython device connected use the\nfollowing command to install:\n\n.. code-block:: shell\n\n    circup install cedargrove_dst_adjuster\n\nOr the following command to update an existing version:\n\n.. code-block:: shell\n\n    circup update\n\nUsage Example\n=============\n\n.. code-block:: python\n\n    import time\n    from cedargrove_dst_adjuster import adjust_dst\n\n    # Today's date: 11/01/2020 00:00 Standard Time (xST)\n    datetime = time.struct_time((2020, 11, 1, 0, 0, 0, 6, 0, -1))\n\n    # Check datetime and adjust if DST\n    adj_datetime, is_dst = adjust_dst(datetime)\n\n    if is_dst:\n        flag_text = \"DST\"\n    else:\n        flag_text = \"xST\"\n\n    # Print the submitted time\n    print(\n        \"     {}/{}/{} {:02}:{:02}:{:02}  week_day={}\".format(\n            datetime.tm_mon,\n            datetime.tm_mday,\n            datetime.tm_year,\n            datetime.tm_hour,\n            datetime.tm_min,\n            datetime.tm_sec,\n            datetime.tm_wday,\n        )\n    )\n\n    # Print the adjusted time\n    print(\n        \"{}: {}/{}/{} {:02}:{:02}:{:02}  week_day={}\".format(\n            flag_text,\n            adj_datetime.tm_mon,\n            adj_datetime.tm_mday,\n            adj_datetime.tm_year,\n            adj_datetime.tm_hour,\n            adj_datetime.tm_min,\n            adj_datetime.tm_sec,\n            adj_datetime.tm_wday,\n        )\n    )\n\nDocumentation\n=============\nAPI documentation for this library can be found `here \u003chttps://github.com/CedarGroveStudios/CircuitPython_DST_Adjuster/blob/main/media/pseudo_rtd_cedargrove_dst_adjuster.pdf\u003e`_.\n\nFor information on building library documentation, please check out\n`this guide \u003chttps://learn.adafruit.com/creating-and-sharing-a-circuitpython-library/sharing-our-docs-on-readthedocs#sphinx-5-1\u003e`_.\n\nContributing\n============\n\nContributions are welcome! Please read our `Code of Conduct\n\u003chttps://github.com/CedarGroveStudios/Cedargrove_CircuitPython_DST_Adjuster/blob/HEAD/CODE_OF_CONDUCT.md\u003e`_\nbefore contributing to help this project stay welcoming.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcedargrovestudios%2Fcircuitpython_dst_adjuster","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcedargrovestudios%2Fcircuitpython_dst_adjuster","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcedargrovestudios%2Fcircuitpython_dst_adjuster/lists"}