mirror of
https://github.com/qgis/QGIS.git
synced 2025-02-25 00:58:06 -05:00
315 lines
8.7 KiB
Plaintext
315 lines
8.7 KiB
Plaintext
/************************************************************************
|
|
* This file has been generated automatically from *
|
|
* *
|
|
* src/core/qgsinterval.h *
|
|
* *
|
|
* Do not edit manually ! Edit header and run scripts/sipify.pl again *
|
|
************************************************************************/
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class QgsInterval
|
|
{
|
|
%Docstring(signature="appended")
|
|
A representation of the interval between two datetime values.
|
|
|
|
.. versionadded:: 2.16
|
|
%End
|
|
|
|
%TypeHeaderCode
|
|
#include "qgsinterval.h"
|
|
%End
|
|
public:
|
|
|
|
static const int YEARS;
|
|
static const int MONTHS;
|
|
static const int WEEKS;
|
|
static const int DAY;
|
|
static const int HOUR;
|
|
static const int MINUTE;
|
|
|
|
QgsInterval();
|
|
%Docstring
|
|
Default constructor for QgsInterval. Creates an invalid interval.
|
|
%End
|
|
|
|
QgsInterval( double seconds );
|
|
%Docstring
|
|
Constructor for QgsInterval.
|
|
|
|
:param seconds: duration of interval in seconds
|
|
%End
|
|
|
|
QgsInterval( double duration, QgsUnitTypes::TemporalUnit unit );
|
|
%Docstring
|
|
Constructor for QgsInterval, using the specified ``duration`` and ``units``.
|
|
%End
|
|
|
|
QgsInterval( double years, double months, double weeks, double days, double hours, double minutes, double seconds );
|
|
%Docstring
|
|
Constructor for QgsInterval, using the specified ``years``, ``months``,
|
|
``weeks``, ``days``, ``hours``, ``minutes`` and ``seconds``.
|
|
|
|
.. note::
|
|
|
|
Month units assumes a 30 day month length.
|
|
|
|
.. note::
|
|
|
|
Year units assumes a 365.25 day year length.
|
|
|
|
.. versionadded:: 3.14
|
|
%End
|
|
|
|
double years() const;
|
|
%Docstring
|
|
Returns the interval duration in years (based on an average year length)
|
|
|
|
If the :py:func:`~QgsInterval.originalUnit` is :py:class:`QgsUnitTypes`.TemporalYears then this value
|
|
will match the exact number of months as returned by :py:func:`~QgsInterval.originalDuration`,
|
|
otherwise it will be calculated using the average year length (31557600 seconds).
|
|
|
|
.. seealso:: :py:func:`setYears`
|
|
%End
|
|
|
|
void setYears( double years );
|
|
%Docstring
|
|
Sets the interval duration in years.
|
|
|
|
Replaces the interval size and changes the original interval unit
|
|
and duration, :py:func:`originalDuration` and \see originalUnit().
|
|
|
|
Changes the original unit to :py:class:`QgsUnitTypes`.TemporalYears
|
|
|
|
:param years: duration in years (based on average year length)
|
|
|
|
.. seealso:: :py:func:`years`
|
|
%End
|
|
|
|
double months() const;
|
|
%Docstring
|
|
Returns the interval duration in months (based on a 30 day month).
|
|
|
|
If the :py:func:`~QgsInterval.originalUnit` is :py:class:`QgsUnitTypes`.TemporalMonths then this value
|
|
will match the exact number of months as returned by :py:func:`~QgsInterval.originalDuration`,
|
|
otherwise it will be calculated using the assumption that
|
|
a month consists of exactly 30 days.
|
|
|
|
.. seealso:: :py:func:`setMonths`
|
|
%End
|
|
|
|
void setMonths( double months );
|
|
%Docstring
|
|
Sets the interval duration in months.
|
|
|
|
Replaces the interval size and changes the original interval unit
|
|
and duration, :py:func:`originalDuration` and \see originalUnit().
|
|
|
|
Changes the original unit to :py:class:`QgsUnitTypes`.TemporalMonths
|
|
|
|
:param months: duration in months (based on a 30 day month)
|
|
|
|
.. seealso:: :py:func:`months`
|
|
%End
|
|
|
|
double weeks() const;
|
|
%Docstring
|
|
Returns the interval duration in weeks.
|
|
|
|
If the :py:func:`~QgsInterval.originalUnit` is :py:class:`QgsUnitTypes`.TemporalWeeks then this value
|
|
will match the exact number of weeks as returned by :py:func:`~QgsInterval.originalDuration`,
|
|
otherwise it will be calculated using the QgsInterval.WEEKS constant.
|
|
|
|
.. seealso:: :py:func:`setWeeks`
|
|
%End
|
|
|
|
void setWeeks( double weeks );
|
|
%Docstring
|
|
Sets the interval duration in weeks.
|
|
|
|
Replaces the interval size and changes the original interval unit
|
|
and duration, :py:func:`originalDuration` and \see originalUnit().
|
|
|
|
Changes the original unit to :py:class:`QgsUnitTypes`.TemporalWeeks
|
|
|
|
:param weeks: duration in weeks
|
|
|
|
.. seealso:: :py:func:`weeks`
|
|
%End
|
|
|
|
double days() const;
|
|
%Docstring
|
|
Returns the interval duration in days.
|
|
|
|
If the :py:func:`~QgsInterval.originalUnit` is :py:class:`QgsUnitTypes`.TemporalDays then this value
|
|
will match the exact number of days as returned by :py:func:`~QgsInterval.originalDuration`,
|
|
otherwise it will be calculated using the QgsInterval.DAY constant.
|
|
|
|
.. seealso:: :py:func:`setDays`
|
|
%End
|
|
|
|
void setDays( double days );
|
|
%Docstring
|
|
Sets the interval duration in days.
|
|
|
|
Replaces the interval size and changes the original interval unit
|
|
and duration, :py:func:`originalDuration` and \see originalUnit().
|
|
|
|
Changes the original unit to :py:class:`QgsUnitTypes`.TemporalDays
|
|
|
|
:param days: duration in days
|
|
|
|
.. seealso:: :py:func:`days`
|
|
%End
|
|
|
|
double hours() const;
|
|
%Docstring
|
|
Returns the interval duration in hours.
|
|
|
|
If the :py:func:`~QgsInterval.originalUnit` is :py:class:`QgsUnitTypes`.TemporalHours then this value
|
|
will match the exact number of hours as returned by :py:func:`~QgsInterval.originalDuration`,
|
|
otherwise it will be calculated using the QgsInterval.HOUR constant.
|
|
|
|
.. seealso:: :py:func:`setHours`
|
|
%End
|
|
|
|
void setHours( double hours );
|
|
%Docstring
|
|
Sets the interval duration in hours.
|
|
|
|
Replaces the interval size and changes the original interval unit
|
|
and duration, :py:func:`originalDuration` and \see originalUnit().
|
|
|
|
The original unit to :py:class:`QgsUnitTypes`.TemporalHours
|
|
|
|
:param hours: duration in hours
|
|
|
|
.. seealso:: :py:func:`hours`
|
|
%End
|
|
|
|
double minutes() const;
|
|
%Docstring
|
|
Returns the interval duration in minutes.
|
|
|
|
If the :py:func:`~QgsInterval.originalUnit` is :py:class:`QgsUnitTypes`.TemporalMinutes then this value
|
|
will match the exact number of minutes as returned by :py:func:`~QgsInterval.originalDuration`,
|
|
otherwise it will be calculated using the QgsInterval.MINUTE constant.
|
|
|
|
.. seealso:: :py:func:`setMinutes`
|
|
%End
|
|
|
|
void setMinutes( double minutes );
|
|
%Docstring
|
|
Sets the interval duration in minutes.
|
|
|
|
Replaces the interval size and changes the original interval unit
|
|
and duration, :py:func:`originalDuration` and \see originalUnit().
|
|
|
|
Changes the original unit to :py:class:`QgsUnitTypes`.TemporalMinutes
|
|
|
|
:param minutes: duration in minutes
|
|
|
|
.. seealso:: :py:func:`minutes`
|
|
%End
|
|
|
|
double seconds() const;
|
|
%Docstring
|
|
Returns the interval duration in seconds.
|
|
|
|
.. seealso:: :py:func:`setSeconds`
|
|
%End
|
|
|
|
void setSeconds( double seconds );
|
|
%Docstring
|
|
Sets the interval duration in seconds.
|
|
|
|
Replaces the interval size and changes the original interval unit
|
|
and duration, :py:func:`originalDuration` and \see originalUnit().
|
|
|
|
Changes the original unit to :py:class:`QgsUnitTypes`.TemporalSeconds
|
|
|
|
:param seconds: duration in seconds
|
|
|
|
.. seealso:: :py:func:`seconds`
|
|
%End
|
|
|
|
bool isValid() const;
|
|
%Docstring
|
|
Returns ``True`` if the interval is valid.
|
|
|
|
.. seealso:: :py:func:`setValid`
|
|
%End
|
|
|
|
void setValid( bool valid );
|
|
%Docstring
|
|
Sets whether the interval is valid.
|
|
|
|
:param valid: set to ``True`` to set the interval as valid.
|
|
|
|
.. seealso:: :py:func:`isValid`
|
|
%End
|
|
|
|
double originalDuration() const;
|
|
%Docstring
|
|
Returns the original interval duration.
|
|
|
|
This original interval duration can be updated through calling
|
|
QgsInterval setter methods.
|
|
|
|
.. seealso:: :py:func:`originalUnit`
|
|
|
|
If the original interval duration is not available or
|
|
interval was set with a mix of units, calling :py:func:`~QgsInterval.originalUnit`
|
|
will return :py:class:`QgsUnitTypes`.TemporalUnknownUnit
|
|
|
|
Returns 0.0 if the original duration was not set.
|
|
|
|
.. versionadded:: 3.18
|
|
%End
|
|
|
|
QgsUnitTypes::TemporalUnit originalUnit() const;
|
|
%Docstring
|
|
Returns the original interval temporal unit.
|
|
|
|
The interval temporal unit can be set through the
|
|
QgsInterval constructors or through the available setter methods.
|
|
|
|
Returns :py:class:`QgsUnitTypes`.TemporalUnknownUnit if unit was not set when creating the
|
|
QgsInterval instance or interval was set with a mix of units.
|
|
|
|
.. seealso:: :py:func:`originalDuration`
|
|
|
|
.. versionadded:: 3.18
|
|
%End
|
|
|
|
bool operator==( QgsInterval other ) const;
|
|
|
|
bool operator!=( QgsInterval other ) const;
|
|
|
|
static QgsInterval fromString( const QString &string );
|
|
%Docstring
|
|
Converts a string to an interval
|
|
|
|
:param string: string to parse
|
|
|
|
:return: interval, or invalid interval if string could not be parsed
|
|
%End
|
|
|
|
operator QVariant() const;
|
|
|
|
};
|
|
|
|
|
|
|
|
/************************************************************************
|
|
* This file has been generated automatically from *
|
|
* *
|
|
* src/core/qgsinterval.h *
|
|
* *
|
|
* Do not edit manually ! Edit header and run scripts/sipify.pl again *
|
|
************************************************************************/
|