# Django Times
Django Times es un modulo el cual busca mejorar y optimizar el trabajo al momento de pasar fechas y dias a los templates en django y asi mejorar el mantenimiento del codigo.
<div align="center">
[](https://opensource.org/licenses/MIT)
[](CHANGELOG.md)
[](https://github.com/estuardodev/django-times/graphs/contributors)
</div>
## Informacion General
Este proyecto proporciona una biblioteca que facilita el trabajo con fechas y horas en aplicaciones Django. Ofrece una serie de etiquetas y funciones personalizadas que permiten obtener y formatear la fecha y hora actual, asi como configurar la zona horaria y el idioma en algunos casos.
## Proyecto
Este proyecto tiene como objetivo simplificar el manejo de fechas y horas en aplicaciones Django. Algunos de los aspectos clave del proyecto incluyen:
- Obtener la fecha y hora actual de acuerdo con la zona horaria configurada en las opciones de Django.
- Formatear la fecha y hora de diferentes maneras segun las necesidades del usuario.
- Personalizar la zona horaria y el idioma para adaptarse a requisitos especificos.
## Instrucciones de Uso
### Instalacion
Para utilizar esta biblioteca en tu proyecto Django, sigue estos pasos:
1. Crea un entorno virtual para tu proyecto (se recomienda, pero opcional).
```python
py -m venv env # Windows
python3 -m virtualenv env # Linux
```
2. Activa el entorno virtual
```python
.\env\Scripts\activate # Windows
source env/bin/activate # Linux
```
3. Instala los django_times
`pip install django-times`
4. INSTALLED_APPS
```python
INSTALLED_APPS = [
...
'django_times',
...
]
```
5. Recoger archivos estaticos
```python
py manage.py collectstatic # Windows
python3 manage.py collectstatic # Linux
```
### Uso
Para usar django times dentro de tus plantillas de django debes de cargar el tag, para ello usa:
`{% load django_times %}`
Y ya puedes usar los distintos tags que te ofrece django-times:
[ver mas...](./docs/TAGS.MD)
## Contribucion
¡Gracias por considerar contribuir a este proyecto! Si deseas contribuir, sigue estos pasos:
1. Crea un fork del repositorio en GitHub.
2. Clona tu repositorio fork en tu entorno de desarrollo local.
`git clone https://github.com/TU_NOMBRE_DE_USUARIO/django-times.git`
3. Crea tu entorno virtual, activalo e instala requirements-dev.txt
4. Crea una rama para tu contribucion.
`git checkout -b mi-contribucion`
5. Realiza tus cambios y realiza confirmaciones significativas.
6. Ejecuta `pre-commit run --all-files`, si falla vuelve a ejecutarlo hasta que todo sea "Passed" de lo contrario soluciona los errores.
7. Envia una solicitud de extraccion (pull request) a la rama principal del proyecto.
8. Tu solicitud de extraccion sera revisada y, si es aceptada, se fusionara con el proyecto principal.
> Recuerda siempre editar el archivo CHANGELOG.md indicando que cambios realizastes, tambien se descriptivo en el mensaje de tu commit y agrega tu nombre a CONTRIBUTORS siguiendo el orden alfabetico.
Raw data
{
"_id": null,
"home_page": "https://github.com/estuardodev/django-times",
"name": "django-times",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "estuardodev,django-times,django,times,python times,python,times django",
"author": "Estuardo Ram\u00edrez",
"author_email": "contacto@estuardo.dev",
"download_url": "https://files.pythonhosted.org/packages/25/a5/fdee271b307a21e90f3bd20e0b31838298abff1ec0d38d233bb0b3f2fc78/django-times-0.1.3.tar.gz",
"platform": null,
"description": "# Django Times\r\n\r\nDjango Times es un modulo el cual busca mejorar y optimizar el trabajo al momento de pasar fechas y dias a los templates en django y asi mejorar el mantenimiento del codigo.\r\n\r\n<div align=\"center\">\r\n\r\n[](https://opensource.org/licenses/MIT)\r\n[](CHANGELOG.md)\r\n[](https://github.com/estuardodev/django-times/graphs/contributors)\r\n\r\n</div>\r\n\r\n## Informacion General\r\n\r\nEste proyecto proporciona una biblioteca que facilita el trabajo con fechas y horas en aplicaciones Django. Ofrece una serie de etiquetas y funciones personalizadas que permiten obtener y formatear la fecha y hora actual, asi como configurar la zona horaria y el idioma en algunos casos.\r\n\r\n## Proyecto\r\n\r\nEste proyecto tiene como objetivo simplificar el manejo de fechas y horas en aplicaciones Django. Algunos de los aspectos clave del proyecto incluyen:\r\n\r\n- Obtener la fecha y hora actual de acuerdo con la zona horaria configurada en las opciones de Django.\r\n- Formatear la fecha y hora de diferentes maneras segun las necesidades del usuario.\r\n- Personalizar la zona horaria y el idioma para adaptarse a requisitos especificos.\r\n\r\n## Instrucciones de Uso\r\n\r\n### Instalacion\r\n\r\nPara utilizar esta biblioteca en tu proyecto Django, sigue estos pasos:\r\n\r\n1. Crea un entorno virtual para tu proyecto (se recomienda, pero opcional).\r\n\r\n ```python\r\n py -m venv env # Windows\r\n python3 -m virtualenv env # Linux\r\n ```\r\n\r\n2. Activa el entorno virtual\r\n\r\n ```python\r\n .\\env\\Scripts\\activate # Windows\r\n source env/bin/activate # Linux\r\n ```\r\n\r\n3. Instala los django_times\r\n\r\n `pip install django-times`\r\n\r\n4. INSTALLED_APPS\r\n\r\n ```python\r\n INSTALLED_APPS = [\r\n ...\r\n 'django_times',\r\n ...\r\n ]\r\n ```\r\n\r\n5. Recoger archivos estaticos\r\n\r\n ```python\r\n py manage.py collectstatic # Windows\r\n python3 manage.py collectstatic # Linux\r\n ```\r\n\r\n### Uso\r\n\r\nPara usar django times dentro de tus plantillas de django debes de cargar el tag, para ello usa:\r\n\r\n `{% load django_times %}`\r\n\r\nY ya puedes usar los distintos tags que te ofrece django-times:\r\n[ver mas...](./docs/TAGS.MD)\r\n\r\n## Contribucion\r\n\r\n\u00c2\u00a1Gracias por considerar contribuir a este proyecto! Si deseas contribuir, sigue estos pasos:\r\n\r\n1. Crea un fork del repositorio en GitHub.\r\n\r\n2. Clona tu repositorio fork en tu entorno de desarrollo local.\r\n`git clone https://github.com/TU_NOMBRE_DE_USUARIO/django-times.git`\r\n\r\n3. Crea tu entorno virtual, activalo e instala requirements-dev.txt\r\n\r\n4. Crea una rama para tu contribucion.\r\n`git checkout -b mi-contribucion`\r\n\r\n5. Realiza tus cambios y realiza confirmaciones significativas.\r\n\r\n6. Ejecuta `pre-commit run --all-files`, si falla vuelve a ejecutarlo hasta que todo sea \"Passed\" de lo contrario soluciona los errores.\r\n\r\n7. Envia una solicitud de extraccion (pull request) a la rama principal del proyecto.\r\n\r\n8. Tu solicitud de extraccion sera revisada y, si es aceptada, se fusionara con el proyecto principal.\r\n\r\n> Recuerda siempre editar el archivo CHANGELOG.md indicando que cambios realizastes, tambien se descriptivo en el mensaje de tu commit y agrega tu nombre a CONTRIBUTORS siguiendo el orden alfabetico.\r\n",
"bugtrack_url": null,
"license": "",
"summary": "Una biblioteca para trabajar con fechas y horas en Django dentro de los templates.",
"version": "0.1.3",
"project_urls": {
"Download": "https://github.com/estuardodev/django-times.git",
"Homepage": "https://github.com/estuardodev/django-times"
},
"split_keywords": [
"estuardodev",
"django-times",
"django",
"times",
"python times",
"python",
"times django"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "57d6da123d5bf0cc169c80aeb0b6b8543798cf41e46ddf8247f581ac05c96bec",
"md5": "39b676a197645da77e38ba8068de3081",
"sha256": "22e209d39ce493490433c9b49d6f131d8baed2fe87c79cf33eda5c4c005928e4"
},
"downloads": -1,
"filename": "django_times-0.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "39b676a197645da77e38ba8068de3081",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 9135,
"upload_time": "2023-09-12T06:56:45",
"upload_time_iso_8601": "2023-09-12T06:56:45.302021Z",
"url": "https://files.pythonhosted.org/packages/57/d6/da123d5bf0cc169c80aeb0b6b8543798cf41e46ddf8247f581ac05c96bec/django_times-0.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "25a5fdee271b307a21e90f3bd20e0b31838298abff1ec0d38d233bb0b3f2fc78",
"md5": "44df6e1166499721b05bf4197718aa10",
"sha256": "fc4c3086704acafe58fb839e5b121aea651c00a15c72be7d0faadd3dc7787089"
},
"downloads": -1,
"filename": "django-times-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "44df6e1166499721b05bf4197718aa10",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 8390,
"upload_time": "2023-09-12T06:56:46",
"upload_time_iso_8601": "2023-09-12T06:56:46.895460Z",
"url": "https://files.pythonhosted.org/packages/25/a5/fdee271b307a21e90f3bd20e0b31838298abff1ec0d38d233bb0b3f2fc78/django-times-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-12 06:56:46",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "estuardodev",
"github_project": "django-times",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "django-times"
}
JSON
