<p align="center">
<em>jaanca public libraries</em>
</p>
<p align="center">
<a href="https://pypi.org/project/jaanca-datetime" target="_blank">
<img src="https://img.shields.io/pypi/v/jaanca-datetime?color=blue&label=PyPI%20Package" alt="Package version">
</a>
<a href="(https://www.python.org" target="_blank">
<img src="https://img.shields.io/badge/Python-%5B%3E%3D3.8%2C%3C%3D3.11%5D-blue" alt="Python">
</a>
</p>
---
# A tool library created by jaanca
* **Python library**: A tool library created by jaanca with help functions for date and time management and moving dates between time days by UTC.
[Source code](https://github.com/jaanca/python-libraries/tree/main/jaanca-datetime)
| [Package (PyPI)](https://pypi.org/project/jaanca-datetime/)
| [Samples](https://github.com/jaanca/python-libraries/tree/main/jaanca-datetime/samples)
---
# library installation
```console
pip install jaanca-datetime --upgrade
```
---
# Example of use
```python
from jaanca_datetime import DateTimeHelper, App, TimeZonesPytz
if __name__=="__main__":
DateTimeHelper.print_console_timezones_pytz()
print(f"date now,is_format_string=False=datetime format: {DateTimeHelper.get_datetime_now(App.Time.POSTGRESQL_FORMAT_DATE,is_format_string=False)}")
print(f"date now,is_format_string=True: {DateTimeHelper.get_datetime_now(App.Time.POSTGRESQL_FORMAT_DATE,is_format_string=True)}")
print(f"date timezone convert UTC to Bogotá,is_format_string=False=datetime format: {DateTimeHelper.get_datetime_now_to_another_location(App.Time.STANDARD_FORMAT_DATE,TimeZonesPytz.US.AZURE_DEFAULT,TimeZonesPytz.America.BOGOTA,is_format_string=False)}")
print(f"date timezone convert UTC to Bogotá,is_format_string=True: {DateTimeHelper.get_datetime_now_to_another_location(App.Time.STANDARD_FORMAT_DATE,TimeZonesPytz.US.AZURE_DEFAULT,TimeZonesPytz.America.BOGOTA,is_format_string=True)}")
# #output
# date now,is_format_string=False=datetime format: 2024-05-24 15:03:04.424853
# date now,is_format_string=True: 2024-05-24 15:03:04
# date timezone convert UTC to Bogotá,is_format_string=False=datetime format: 2024-05-24 10:03:04.425853-05:00
# date timezone convert UTC to Bogotá,is_format_string=True: 2024-05-24 10:03:04
```
---
# Semantic Versioning
jaanca-datetime < MAJOR >.< MINOR >.< PATCH >
* **MAJOR**: version when you make incompatible API changes
* **MINOR**: version when you add functionality in a backwards compatible manner
* **PATCH**: version when you make backwards compatible bug fixes
## Definitions for releasing versions
* https://peps.python.org/pep-0440/
- X.YaN (Alpha release): Identify and fix early-stage bugs. Not suitable for production use.
- X.YbN (Beta release): Stabilize and refine features. Address reported bugs. Prepare for official release.
- X.YrcN (Release candidate): Final version before official release. Assumes all major features are complete and stable. Recommended for testing in non-critical environments.
- X.Y (Final release/Stable/Production): Completed, stable version ready for use in production. Full release for public use.
---
# Changelog
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## Types of changes
- Added for new features.
- Changed for changes in existing functionality.
- Deprecated for soon-to-be removed features.
- Removed for now removed features.
- Fixed for any bug fixes.
- Security in case of vulnerabilities.
## [0.0.1rcX] - 2024-05-24
### Added
- First tests using pypi.org in develop environment.
## [0.1.0] - 2024-05-24
### Added
- Completion of testing and launch into production.
Raw data
{
"_id": null,
"home_page": "https://github.com/jaanca/python-libraries/tree/main/jaanca-datetime",
"name": "jaanca-datetime",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "datetime, utc",
"author": "Jaime Andres Cardona Carrillo",
"author_email": "jacardona@outlook.com",
"download_url": "https://files.pythonhosted.org/packages/71/f4/c8e895e16bb4cc4ee5f76cebd050316b2f0a5310e7c4adecd5cd69cf11ef/jaanca_datetime-0.1.0.tar.gz",
"platform": null,
"description": "<p align=\"center\">\r\n <em>jaanca public libraries</em>\r\n</p>\r\n\r\n<p align=\"center\">\r\n<a href=\"https://pypi.org/project/jaanca-datetime\" target=\"_blank\">\r\n <img src=\"https://img.shields.io/pypi/v/jaanca-datetime?color=blue&label=PyPI%20Package\" alt=\"Package version\">\r\n</a>\r\n<a href=\"(https://www.python.org\" target=\"_blank\">\r\n <img src=\"https://img.shields.io/badge/Python-%5B%3E%3D3.8%2C%3C%3D3.11%5D-blue\" alt=\"Python\">\r\n</a>\r\n</p>\r\n\r\n\r\n---\r\n\r\n# A tool library created by jaanca\r\n\r\n* **Python library**: A tool library created by jaanca with help functions for date and time management and moving dates between time days by UTC.\r\n\r\n[Source code](https://github.com/jaanca/python-libraries/tree/main/jaanca-datetime)\r\n| [Package (PyPI)](https://pypi.org/project/jaanca-datetime/)\r\n| [Samples](https://github.com/jaanca/python-libraries/tree/main/jaanca-datetime/samples)\r\n\r\n---\r\n\r\n# library installation\r\n```console\r\npip install jaanca-datetime --upgrade\r\n```\r\n\r\n---\r\n# Example of use\r\n\r\n```python\r\nfrom jaanca_datetime import DateTimeHelper, App, TimeZonesPytz\r\n\r\nif __name__==\"__main__\":\r\n DateTimeHelper.print_console_timezones_pytz()\r\n print(f\"date now,is_format_string=False=datetime format: {DateTimeHelper.get_datetime_now(App.Time.POSTGRESQL_FORMAT_DATE,is_format_string=False)}\")\r\n print(f\"date now,is_format_string=True: {DateTimeHelper.get_datetime_now(App.Time.POSTGRESQL_FORMAT_DATE,is_format_string=True)}\")\r\n print(f\"date timezone convert UTC to Bogot\u00c3\u00a1,is_format_string=False=datetime format: {DateTimeHelper.get_datetime_now_to_another_location(App.Time.STANDARD_FORMAT_DATE,TimeZonesPytz.US.AZURE_DEFAULT,TimeZonesPytz.America.BOGOTA,is_format_string=False)}\")\r\n print(f\"date timezone convert UTC to Bogot\u00c3\u00a1,is_format_string=True: {DateTimeHelper.get_datetime_now_to_another_location(App.Time.STANDARD_FORMAT_DATE,TimeZonesPytz.US.AZURE_DEFAULT,TimeZonesPytz.America.BOGOTA,is_format_string=True)}\")\r\n\r\n# #output\r\n# date now,is_format_string=False=datetime format: 2024-05-24 15:03:04.424853\r\n# date now,is_format_string=True: 2024-05-24 15:03:04\r\n# date timezone convert UTC to Bogot\u00c3\u00a1,is_format_string=False=datetime format: 2024-05-24 10:03:04.425853-05:00\r\n# date timezone convert UTC to Bogot\u00c3\u00a1,is_format_string=True: 2024-05-24 10:03:04\r\n \r\n```\r\n\r\n---\r\n\r\n# Semantic Versioning\r\n\r\njaanca-datetime < MAJOR >.< MINOR >.< PATCH >\r\n\r\n* **MAJOR**: version when you make incompatible API changes\r\n* **MINOR**: version when you add functionality in a backwards compatible manner\r\n* **PATCH**: version when you make backwards compatible bug fixes\r\n\r\n## Definitions for releasing versions\r\n* https://peps.python.org/pep-0440/\r\n\r\n - X.YaN (Alpha release): Identify and fix early-stage bugs. Not suitable for production use.\r\n - X.YbN (Beta release): Stabilize and refine features. Address reported bugs. Prepare for official release.\r\n - X.YrcN (Release candidate): Final version before official release. Assumes all major features are complete and stable. Recommended for testing in non-critical environments.\r\n - X.Y (Final release/Stable/Production): Completed, stable version ready for use in production. Full release for public use.\r\n---\r\n\r\n# Changelog\r\n\r\nAll notable changes to this project will be documented in this file.\r\n\r\nThe format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),\r\nand this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).\r\n\r\n## Types of changes\r\n\r\n- Added for new features.\r\n- Changed for changes in existing functionality.\r\n- Deprecated for soon-to-be removed features.\r\n- Removed for now removed features.\r\n- Fixed for any bug fixes.\r\n- Security in case of vulnerabilities.\r\n\r\n## [0.0.1rcX] - 2024-05-24\r\n### Added\r\n- First tests using pypi.org in develop environment.\r\n\r\n## [0.1.0] - 2024-05-24\r\n### Added\r\n- Completion of testing and launch into production.\r\n\r\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "A tool library created by jaanca with help functions for date and time management and moving dates between time days by UTC.",
"version": "0.1.0",
"project_urls": {
"Homepage": "https://github.com/jaanca/python-libraries/tree/main/jaanca-datetime"
},
"split_keywords": [
"datetime",
" utc"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "74a3e02abc76b966a43872af1c39707efc99ee6406f5eadc6fac13dcb2f219ff",
"md5": "56ede3079367059c40e4bd225d2f3d90",
"sha256": "3b4c681c9d061426b21f8123b996cbc7724ae99bc703d9f1fa05d67e146972b8"
},
"downloads": -1,
"filename": "jaanca_datetime-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "56ede3079367059c40e4bd225d2f3d90",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 5552,
"upload_time": "2024-05-24T20:08:30",
"upload_time_iso_8601": "2024-05-24T20:08:30.153913Z",
"url": "https://files.pythonhosted.org/packages/74/a3/e02abc76b966a43872af1c39707efc99ee6406f5eadc6fac13dcb2f219ff/jaanca_datetime-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "71f4c8e895e16bb4cc4ee5f76cebd050316b2f0a5310e7c4adecd5cd69cf11ef",
"md5": "d42c2b52f529176ec73040b572a3eea6",
"sha256": "f15f61c20d4e79c0d12f41c99100d94140ce42e819b88521eb582da0477c6649"
},
"downloads": -1,
"filename": "jaanca_datetime-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "d42c2b52f529176ec73040b572a3eea6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 4886,
"upload_time": "2024-05-24T20:08:31",
"upload_time_iso_8601": "2024-05-24T20:08:31.347462Z",
"url": "https://files.pythonhosted.org/packages/71/f4/c8e895e16bb4cc4ee5f76cebd050316b2f0a5310e7c4adecd5cd69cf11ef/jaanca_datetime-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-24 20:08:31",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jaanca",
"github_project": "python-libraries",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "jaanca-datetime"
}