معرفی شرکت ها
django-relativedelta-2.0.0
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Django alternative to DurationField using dateutil.relativedelta
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | django-relativedelta-2.0.0 |
| نام | django-relativedelta |
| نسخه کتابخانه | 2.0.0 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Code Yellow B.V. |
| ایمیل نویسنده | django-relativedelta@codeyellow.nl |
| آدرس صفحه اصلی | https://github.com/CodeYellowBV/django-relativedelta |
| آدرس اینترنتی | https://pypi.org/project/django-relativedelta/ |
| مجوز | MIT License |
django-relativedelta
====================
.. image:: https://travis-ci.org/CodeYellowBV/django-relativedelta.svg?branch=master
:target: https://travis-ci.org/CodeYellowBV/django-relativedelta
A Django field for the `dateutil.relativedelta.relativedelta <http://dateutil.readthedocs.io/en/stable/relativedelta.html>`_ class,
which conveniently maps to the `PostgreSQL INTERVAL type <https://www.postgresql.org/docs/current/static/datatype-datetime.html#DATATYPE-INTERVAL-INPUT>`_.
The standard `Django DurationField <https://docs.djangoproject.com/en/1.10/ref/models/fields/#durationfield>`_
maps to `Python's datetime.timedelta <https://docs.python.org/3/library/datetime.html#datetime.timedelta>`_, which
has support for days and weeks, but not for years and months. And if you try to read an ``INTERVAL`` that contains
months anyway, information is lost because each month gets converted to 30 days.
For compatibility, a `VARCHAR` field is used on other databases. This
uses a custom relativedelta representation. However, this means that
true in-database interval operations are not supported in these
databases. Sorting and comparing between two relativedelta fields or
a relativedelta field and a fixed relativedelta value is supported,
however.
You should use this package when you need to store payment intervals
(which tend to be monthly or quarterly), publication intervals (which
can be weekly but also monthly) and so on, or when you simply don't
know what the intervals are going to be and want to offer some
flexibility.
If you want to use more advanced recurring dates, you should consider
using `django-recurrence <https://github.com/django-recurrence/django-recurrence>`_
instead. This maps to the `dateutil.rrule.rrule <http://dateutil.readthedocs.io/en/stable/rrule.html>`_
class, but it doesn't use native database field types, so you can't
perform arithmetic on them within the database.
Usage
-----
Using the field is straightforward. You can add the field to your
model like so:
.. code:: python
from django.db import models
from relativedeltafield import RelativeDeltaField
class MyModel(models.Model):
rdfield=RelativeDeltaField()
Then later, you can use it:
.. code:: python
from dateutil.relativedelta import relativedelta
rd = relativedelta(months=2,days=1,hours=6)
my_model = MyModel(rdfield=rd)
my_model.save()
Or, alternatively, you can use a string with the
`ISO8601 "format with designators" time interval syntax <https://www.postgresql.org/docs/current/static/datatype-datetime.html#DATATYPE-INTERVAL-INPUT>`_:
.. code:: python
from dateutil.relativedelta import relativedelta
my_model = MyModel(rdfield='P2M1DT6H')
my_model.save()
For convenience, a standard Python ``datetime.timedelta`` object is
also accepted:
.. code:: python
from datetime import timedelta
td = timedelta(days=62,hours=6)
my_model = MyModel(rdfield=td)
my_model.save()
After a ``full_clean()``, the object will always be converted to a
_normalized_ ``relativedelta`` instance. It is highly recommended
you use the `django-fullclean <https://github.com/fish-ball/django-fullclean>`_
app to always force ``full_clean()`` on ``save()``, so you can be
sure that after a ``save()``, your fields are both normalized
and validated.
Limitations and pitfalls
------------------------
Because this field is backed by an ``INTERVAL`` column, it neither
supports the relative ``weekday``, ``leapdays``, ``yearday`` and
``nlyearday`` arguments, nor the absolute arguments ``year``,
``month``, ``day``, ``hour``, ``second`` and ``microsecond``.
The ``microseconds`` field is converted to a fractional ``seconds``
value, which might lead to some precision loss due to floating-point
representation.
The ``weeks`` field is "virtual", being derived from the multiple of 7
days. Thus, any week value in the input interval specification is
converted to days and added to the ``days`` field of the interval.
When serializing back to a string, weeks will never be written.
Similarly, if the interval contains a multiple of 7 days, you can read
this back out from the ``weeks`` property.
Support for databases other than PostgreSQL is limited.
For consistency reasons, when a relativedelta object is assigned to a
RelativeDeltaField, it automatically calls ``normalized()`` on
``full_clean``. This ensures that the database representation is as
similar to the relativedelta as possible (for instance, fractional
days are always converted to hours).
نیازمندی
| مقدار | نام |
|---|---|
| >=1.10 | Django |
| >=2.6.0 | python-dateutil |
| <=2.8.6 | psycopg2-binary |
| >=6.0.2 | pytest |
| >=0.7.3 | pytest-pythonpath |
| >=1.7.1 | pytest-echo |
| - | pytest-coverage |
| >=3.7.0 | pytest-django |
| >=3.14.3 | tox |
| >=1.1.0 | tox-pyenv |
| >=1.0.0 | bump2version |
| >=3.8.3 | flake8 |
| >=5.5.3 | isort |
| >=2.0.1 | mysqlclient |
نحوه نصب
نصب پکیج whl django-relativedelta-2.0.0:
pip install django-relativedelta-2.0.0.whl
نصب پکیج tar.gz django-relativedelta-2.0.0:
pip install django-relativedelta-2.0.0.tar.gz