KCal Library
KCal::Duration Class Reference
Represents a span of time measured in seconds or days. More...
#include <duration.h>
Public Types | |
enum | Type { Seconds, Days } |
Public Member Functions | |
int | asDays () const |
int | asSeconds () const |
Duration (const Duration &duration) | |
Duration (int duration, Type type=Seconds) | |
Duration (const KDateTime &start, const KDateTime &end, Type type) | |
Duration (const KDateTime &start, const KDateTime &end) | |
Duration () | |
KDateTime | end (const KDateTime &start) const |
bool | isDaily () const |
operator bool () const | |
bool | operator! () const |
bool | operator!= (const Duration &other) const |
Duration | operator* (int value) const |
Duration & | operator*= (int value) |
Duration | operator+ (const Duration &other) const |
Duration & | operator+= (const Duration &other) |
Duration | operator- (const Duration &other) const |
Duration | operator- () const |
Duration & | operator-= (const Duration &other) |
Duration | operator/ (int value) const |
Duration & | operator/= (int value) |
bool | operator< (const Duration &other) const |
bool | operator<= (const Duration &other) const |
Duration & | operator= (const Duration &duration) |
bool | operator== (const Duration &other) const |
bool | operator> (const Duration &other) const |
bool | operator>= (const Duration &other) const |
Type | type () const |
int | value () const |
~Duration () |
Detailed Description
Represents a span of time measured in seconds or days.A duration is a span of time measured in seconds or days. Construction can be done by specifying a stop and end time, or simply by specifying the number of seconds or days.
Much of the time, it does not matter whether a duration is specified in seconds or in days. But it does make a difference when a duration is used to define a time period encompassing a daylight saving time change.
Definition at line 52 of file duration.h.
Member Enumeration Documentation
enum KCal::Duration::Type |
Constructor & Destructor Documentation
Duration::Duration | ( | ) |
Constructs a duration of 0 seconds.
Private class that helps to provide binary compatibility between releases.
For internal use only.
Definition at line 54 of file duration.cpp.
Duration::Duration | ( | const KDateTime & | start, | |
const KDateTime & | end | |||
) |
Constructs a duration from start
to end
.
If the time of day in start
and end
is equal, and their time specifications (i.e. time zone etc.) are the same, the duration will be set in terms of days. Otherwise, the duration will be set in terms of seconds.
- Parameters:
-
start is the time the duration begins. end is the time the duration ends.
Definition at line 59 of file duration.cpp.
Duration::Duration | ( | const KDateTime & | start, | |
const KDateTime & | end, | |||
Type | type | |||
) |
Constructs a duration from start
to end
.
If type
is Days, and the time of day in start's
time zone differs between start
and end
, the duration will be rounded down to the nearest whole number of days.
- Parameters:
-
start is the time the duration begins. end is the time the duration ends. type the unit of time to use (seconds or days)
Definition at line 71 of file duration.cpp.
Duration::Duration | ( | int | duration, | |
Type | type = Seconds | |||
) |
Constructs a duration with a number of seconds or days.
- Parameters:
-
duration the number of seconds or days in the duration type the unit of time to use (seconds or days)
Definition at line 96 of file duration.cpp.
Duration::Duration | ( | const Duration & | duration | ) |
Constructs a duration by copying another duration object.
- Parameters:
-
duration is the duration to copy.
Definition at line 103 of file duration.cpp.
Duration::~Duration | ( | ) |
Member Function Documentation
int Duration::asDays | ( | ) | const |
Returns the length of the duration in days.
If the duration is not an exact number of days, it is rounded down to return the number of whole days.
Definition at line 196 of file duration.cpp.
int Duration::asSeconds | ( | ) | const |
KDateTime Duration::end | ( | const KDateTime & | start | ) | const |
Computes a duration end time by adding the number of seconds or days in the duration to the specified start
time.
- Parameters:
-
start is the start time.
- Returns:
- end time.
Definition at line 175 of file duration.cpp.
bool Duration::isDaily | ( | ) | const |
Returns whether the duration is specified in terms of days rather than seconds.
Definition at line 186 of file duration.cpp.
Duration::operator bool | ( | ) | const |
bool KCal::Duration::operator! | ( | ) | const [inline] |
bool KCal::Duration::operator!= | ( | const Duration & | other | ) | const [inline] |
Returns true if this duration is not equal to the other
.
- Parameters:
-
other is the other duration to compare.
Definition at line 169 of file duration.h.
Duration KCal::Duration::operator* | ( | int | value | ) | const [inline] |
Multiplies a duration by a value.
- Parameters:
-
value value to multiply by
- Returns:
- resultant duration
Definition at line 228 of file duration.h.
Duration & Duration::operator*= | ( | int | value | ) |
Multiplies this duration by a value.
- Parameters:
-
value value to multiply by
Definition at line 163 of file duration.cpp.
Adds two durations.
If one is in terms of days and the other in terms of seconds, the result is in terms of seconds.
- Parameters:
-
other the other duration to add
- Returns:
- combined duration
Definition at line 188 of file duration.h.
Adds another duration to this one.
If one is in terms of days and the other in terms of seconds, the result is in terms of seconds.
- Parameters:
-
other the other duration to add
Definition at line 140 of file duration.cpp.
Returns the difference between another duration and this.
If one is in terms of days and the other in terms of seconds, the result is in terms of seconds.
- Parameters:
-
other the other duration to subtract
- Returns:
- difference in durations
Definition at line 213 of file duration.h.
Duration Duration::operator- | ( | ) | const |
Subtracts another duration from this one.
If one is in terms of days and the other in terms of seconds, the result is in terms of seconds.
- Parameters:
-
other the other duration to subtract
Definition at line 158 of file duration.cpp.
Duration KCal::Duration::operator/ | ( | int | value | ) | const [inline] |
Divides a duration by a value.
- Parameters:
-
value value to divide by
- Returns:
- resultant duration
Definition at line 243 of file duration.h.
Duration & Duration::operator/= | ( | int | value | ) |
Divides this duration by a value.
- Parameters:
-
value value to divide by
Definition at line 169 of file duration.cpp.
bool Duration::operator< | ( | const Duration & | other | ) | const |
Returns true if this duration is smaller than the other
.
- Parameters:
-
other is the other duration to compare.
Definition at line 124 of file duration.cpp.
bool KCal::Duration::operator<= | ( | const Duration & | other | ) | const [inline] |
Returns true if this duration is smaller than or equal to the other
.
- Parameters:
-
other is the other duration to compare.
Definition at line 141 of file duration.h.
Sets this duration equal to duration
.
- Parameters:
-
duration is the duration to copy.
Definition at line 113 of file duration.cpp.
bool Duration::operator== | ( | const Duration & | other | ) | const |
Returns true if this duration is equal to the other
.
A daily and non-daily duration are considered unequal.
- Parameters:
-
other the other duration to compare
Definition at line 133 of file duration.cpp.
bool KCal::Duration::operator> | ( | const Duration & | other | ) | const [inline] |
Returns true if this duration is greater than the other
.
- Parameters:
-
other is the other duration to compare.
Definition at line 148 of file duration.h.
bool KCal::Duration::operator>= | ( | const Duration & | other | ) | const [inline] |
Returns true if this duration is greater than or equal to the other
.
- Parameters:
-
other is the other duration to compare.
Definition at line 155 of file duration.h.
Duration::Type Duration::type | ( | ) | const |
Returns the time units (seconds or days) used to specify the duration.
Definition at line 181 of file duration.cpp.
int Duration::value | ( | ) | const |
Returns the length of the duration in seconds or days.
- Returns:
- if isDaily(), duration in days, else duration in seconds
Definition at line 201 of file duration.cpp.
The documentation for this class was generated from the following files: