indexing
description: "Duration of dates and times"
legal: "See notice at end of class."
status: "See notice at end of class."
date: "$Date: 2006-01-22 18:25:44 -0800 (Sun, 22 Jan 2006) $"
revision: "$Revision: 56675 $"
access: date, time
class interface
DATE_TIME_DURATION
create
make (y, mo, d, h, mi, s: INTEGER_32)
yearmonthday`y'`mo'`d'
hourminutesecond`h'`mi'`s'
ensure
date_exists: date /= Void
time_exists: time /= Void
year_set: year = y
month_set: month = mo
day_set: day = d
hour_set: hour = h
minute_set: minute = mi
second_set: second = s
make_definite (d, h, m, s: INTEGER_32)
day`d'
hourminutesecond`h'`m'`s'
ensure
date_exists: date /= Void
time_exists: time /= Void
definite_result: definite
day_set: day = d
hour_set: hour = h
minute_set: minute = m
second_set: second = s
make_fine (y, mo, d, h, mi: INTEGER_32; s: REAL_64)
yearmonthday`y'`mo'`d'
hourminutesecond`h'`mi'`s'
ensure
date_exists: date /= Void
time_exists: time /= Void
year_set: year = y
month_set: month = mo
day_set: day = d
hour_set: hour = h
minute_set: minute = mi
fine_second_set: fine_second = s
make_by_date_time (d: DATE_DURATION; t: TIME_DURATION)
date`d'time`t'
require
date_exists: d /= Void
time_exists: t /= Void
ensure
date_set: date = d
time_set: time = t
make_by_date (d: DATE_DURATION)
date`d'time
require
d_exists: d /= Void
ensure
date_set: date = d
time_exists: time /= Void
time_set: time.is_equal (time.zero)
feature
make (y, mo, d, h, mi, s: INTEGER_32)
yearmonthday`y'`mo'`d'
hourminutesecond`h'`mi'`s'
ensure
date_exists: date /= Void
time_exists: time /= Void
year_set: year = y
month_set: month = mo
day_set: day = d
hour_set: hour = h
minute_set: minute = mi
second_set: second = s
make_by_date (d: DATE_DURATION)
date`d'time
require
d_exists: d /= Void
ensure
date_set: date = d
time_exists: time /= Void
time_set: time.is_equal (time.zero)
make_by_date_time (d: DATE_DURATION; t: TIME_DURATION)
date`d'time`t'
require
date_exists: d /= Void
time_exists: t /= Void
ensure
date_set: date = d
time_set: time = t
make_definite (d, h, m, s: INTEGER_32)
day`d'
hourminutesecond`h'`m'`s'
ensure
date_exists: date /= Void
time_exists: time /= Void
definite_result: definite
day_set: day = d
hour_set: hour = h
minute_set: minute = m
second_set: second = s
make_fine (y, mo, d, h, mi: INTEGER_32; s: REAL_64)
yearmonthday`y'`mo'`d'
hourminutesecond`h'`mi'`s'
ensure
date_exists: date /= Void
time_exists: time /= Void
year_set: year = y
month_set: month = mo
day_set: day = d
hour_set: hour = h
minute_set: minute = mi
fine_second_set: fine_second = s
feature
date_default_format_string: STRING_8
DATE_CONSTANTS
date_time_tools: DATE_TIME_TOOLS
TIME_UTILITY
day: INTEGER_32
DATE_TIME_MEASUREMENT
ensure DATE_TIME_MEASUREMENT
same_day: Result = date.day
days_in_i_th_month (i, y: INTEGER_32): INTEGER_32
`i'`y'
DATE_CONSTANTS
require DATE_CONSTANTS
i_large_enough: i >= 1
i_small_enough: i <= months_in_year
days_in_leap_year: INTEGER_32 is 366
DATE_CONSTANTS
days_in_non_leap_year: INTEGER_32 is 365
DATE_CONSTANTS
days_in_week: INTEGER_32 is 7
DATE_CONSTANTS
days_text: ARRAY [STRING_8]
DATE_CONSTANTS
default_format_string: STRING_8
TIME_UTILITY
fine_second: REAL_64
DATE_TIME_MEASUREMENT
ensure DATE_TIME_MEASUREMENT
same_fine_second: Result = time.fine_second
generating_type: STRING_8
ANY
generator: STRING_8
ANY
hour: INTEGER_32
DATE_TIME_MEASUREMENT
ensure DATE_TIME_MEASUREMENT
same_hour: Result = time.hour
hours_in_day: INTEGER_32 is 24
TIME_CONSTANTS
long_days_text: ARRAY [STRING_8]
DATE_CONSTANTS
long_months_text: ARRAY [STRING_8]
DATE_CONSTANTS
max_weeks_in_year: INTEGER_32 is 53
DATE_CONSTANTS
minute: INTEGER_32
DATE_TIME_MEASUREMENT
ensure DATE_TIME_MEASUREMENT
same_minute: Result = time.minute
minutes_in_hour: INTEGER_32 is 60
TIME_CONSTANTS
month: INTEGER_32
DATE_TIME_MEASUREMENT
ensure DATE_TIME_MEASUREMENT
same_month: Result = date.month
months_in_year: INTEGER_32 is 12
DATE_CONSTANTS
months_text: ARRAY [STRING_8]
DATE_CONSTANTS
second: INTEGER_32
DATE_TIME_MEASUREMENT
ensure DATE_TIME_MEASUREMENT
same_second: Result = time.second
seconds_in_day: INTEGER_32 is 86400
TIME_CONSTANTS
seconds_in_hour: INTEGER_32 is 3600
TIME_CONSTANTS
seconds_in_minute: INTEGER_32 is 60
TIME_CONSTANTS
time_default_format_string: STRING_8
TIME_CONSTANTS
year: INTEGER_32
DATE_TIME_MEASUREMENT
ensure DATE_TIME_MEASUREMENT
same_year: Result = date.year
feature
frozen deep_equal (some: ANY; other: like arg #1): BOOLEAN
`some'`other'
ANY
ensure ANY
shallow_implies_deep: standard_equal (some, other) implies Result
both_or_none_void: (some = Void) implies (Result = (other = Void))
same_type: (Result and (some /= Void)) implies some.same_type (other)
symmetric: Result implies deep_equal (other, some)
frozen equal (some: ANY; other: like arg #1): BOOLEAN
`some'`other'
ANY
ensure ANY
definition: Result = (some = Void and other = Void) or else ((some /= Void and other /= Void) and then some.is_equal (other))
is_equal (other: like Current): BOOLEAN
`other'
require ANY
other_not_void: other /= Void
ensure ANY
symmetric: Result implies other.is_equal (Current)
consistent: standard_is_equal (other) implies Result
frozen standard_equal (some: ANY; other: like arg #1): BOOLEAN
`some'`other'
ANY
ensure ANY
definition: Result = (some = Void and other = Void) or else ((some /= Void and other /= Void) and then some.standard_is_equal (other))
frozen standard_is_equal (other: like Current): BOOLEAN
`other'
ANY
require ANY
other_not_void: other /= Void
ensure ANY
same_type: Result implies same_type (other)
symmetric: Result implies other.standard_is_equal (Current)
infix "<" (other: like Current): BOOLEAN
`other'
require PART_COMPARABLE
other_exists: other /= Void
ensure then
non_definite_result: not (definite and other.definite) implies Result = False
infix "<=" (other: like Current): BOOLEAN
`other'
PART_COMPARABLE
require PART_COMPARABLE
other_exists: other /= Void
infix ">" (other: like Current): BOOLEAN
`other'
PART_COMPARABLE
require PART_COMPARABLE
other_exists: other /= Void
infix ">=" (other: like Current): BOOLEAN
`other'
PART_COMPARABLE
require PART_COMPARABLE
other_exists: other /= Void
feature
canonical (start_date: DATE_TIME): BOOLEAN
conforms_to (other: ANY): BOOLEAN
`other'
ANY
require ANY
other_not_void: other /= Void
definite: BOOLEAN
dayyearmonth
ensure
result_definition: Result = (year = 0 and then month = 0)
has_origin_date_time: BOOLEAN
origin_date_time
is_leap_year (y: INTEGER_32): BOOLEAN
`y'
DATE_CONSTANTS
is_negative: BOOLEAN
DURATION
is_positive: BOOLEAN
is_zero: BOOLEAN
DURATION
same_type (other: ANY): BOOLEAN
`other'
ANY
require ANY
other_not_void: other /= Void
ensure ANY
definition: Result = (conforms_to (other) and other.conforms_to (Current))
feature
set_origin_date_time (dt: DATE_TIME)
origin_date_time`dt'
ensure
origin_date_time_set: origin_date_time = dt
origin_date_set: origin_date_time /= Void implies (origin_date_time.date = date.origin_date)
feature
prefix "+": like Current
DURATION
ensure GROUP_ELEMENT
result_exists: Result /= Void
result_definition: Result.is_equal (Current)
infix "-" (other: like Current): like Current
`other'
DURATION
require GROUP_ELEMENT
other_exists: other /= Void
ensure GROUP_ELEMENT
result_exists: Result /= Void
feature
time_to_canonical: like Current
timedate
require
definite_duration: definite
ensure
time_canonical: Result.time.canonical
same_sign: ((Result.date > date.zero) implies (Result.time >= time.zero)) and then ((Result.date < date.zero) implies (Result.time <= time.zero))
to_canonical (start_date: DATE_TIME): like Current
`start_date'
ensure
canonical_set: Result.canonical (start_date)
duration_not_changed: equal (start_date + Current, start_date + Result)
feature
copy (other: like Current)
`other'
ANY
require ANY
other_not_void: other /= Void
type_identity: same_type (other)
ensure ANY
is_equal: is_equal (other)
frozen deep_copy (other: like Current)
copy`other'deep_twin
ANY
require ANY
other_not_void: other /= Void
ensure ANY
deep_equal: deep_equal (Current, other)
frozen deep_twin: like Current
ANY
ensure ANY
deep_equal: deep_equal (Current, Result)
frozen standard_copy (other: like Current)
`other'
ANY
require ANY
other_not_void: other /= Void
type_identity: same_type (other)
ensure ANY
is_standard_equal: standard_is_equal (other)
frozen standard_twin: like Current
`other'
ANY
ensure ANY
standard_twin_not_void: Result /= Void
equal: standard_equal (Result, Current)
frozen twin: like Current
`Current'
twincopycopy
ANY
ensure ANY
twin_not_void: Result /= Void
is_equal: Result.is_equal (Current)
feature
day_add (d: INTEGER_32)
`d'
ensure
result_definition: day = old day + d
frozen default: like Current
ANY
frozen default_pointer: POINTER
`POINTER'
`p'default
`p'`POINTER'
ANY
default_rescue
ANY
frozen do_nothing
ANY
infix "+" (other: like Current): like Current
`other'
require GROUP_ELEMENT
other_exists: other /= Void
ensure GROUP_ELEMENT
result_exists: Result /= Void
commutative: Result.is_equal (other + Current)
ensure then
origin_date_time: equal (origin_date_time, Result.origin_date_time)
prefix "-": like Current
require GROUP_ELEMENT
True
ensure GROUP_ELEMENT
result_exists: Result /= Void
result_definition: (Result + Current).is_equal (zero)
ensure then
origin_date_time: equal (origin_date_time, Result.origin_date_time)
feature
date: DATE_DURATION
fine_seconds_count: REAL_64
require
has_origin: has_origin_date_time
origin_date_time: DATE_TIME
seconds_count: INTEGER_64
require
has_origin: has_origin_date_time
time: TIME_DURATION
zero: DATE_TIME_DURATION
ensure GROUP_ELEMENT
result_exists: Result /= Void
feature
set_date (d: DATE_DURATION)
date`d'
require
d_exists: d /= Void
ensure
date_set: date = d
set_time (t: TIME_DURATION)
time`t'
require
t_exists: time /= Void
ensure
time_set: time = t
feature
io: STD_FILES
ANY
out: STRING_8
ANYtagged_out
ANY
print (some: ANY)
`some'
ANY
frozen tagged_out: STRING_8
ANYout
ANY
feature
operating_environment: OPERATING_ENVIRONMENT
ANY
invariant
date_exists: date /= Void
time_exists: time /= Void
origin_constraint: (origin_date_time = Void and date.origin_date = Void) or else origin_date_time.date = date.origin_date
same_signs: (has_origin_date_time and then canonical (origin_date_time)) implies ((date.is_positive or date.is_zero) and (time.is_positive or time.is_zero)) or else ((date.is_negative or date.is_zero) and (time.is_negative or time.is_zero))
DURATION
sign_correctness: is_positive xor is_negative xor is_zero
ANY
reflexive_equality: standard_is_equal (Current)
reflexive_conformance: conforms_to (Current)
GROUP_ELEMENT
neutral_addition: Current.is_equal (Current + zero)
self_subtraction: zero.is_equal (Current - Current)
DATE_TIME_MEASUREMENT
date_exists: date /= Void
time_exists: time /= Void
indexing
copyright: "Copyright (c) 1984-2006, Eiffel Software and others"
license: "Eiffel Forum License v2 (see http://www.eiffel.com/licensing/forum.txt)"
source: "[
Eiffel Software
356 Storke Road, Goleta, CA 93117 USA
Telephone 805-685-1006, Fax 805-685-6869
Website http://www.eiffel.com
Customer support http://support.eiffel.com
]"
end DATE_TIME_DURATION