indexing
description: "Absolute dates"
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
class interface
DATE
create
make (y, m, d: INTEGER_32)
yearmonthday`y'`m'`d'
require
correct_date: is_correct_date (y, m, d)
ensure
year_set: year = y
month_set: month = m
day_set: day = d
make_month_day_year (m, d, y: INTEGER_32)
monthdayyear`m'`d'`y'
require
correct_date: is_correct_date (y, m, d)
ensure
year_set: year = y
month_set: month = m
day_set: day = d
make_day_month_year (d, m, y: INTEGER_32)
daymonthyear`d'`m'`y'
require
correct_date: is_correct_date (y, m, d)
ensure
year_set: year = y
month_set: month = m
day_set: day = d
make_now
make_now_utc
make_by_days (n: INTEGER_32)
`n'Origin
ensure
days_set: days = n
make_from_string_default (s: STRING_8)
date_default_format_string
require
s_exists: s /= Void
date_valid: date_valid (s, date_default_format_string)
make_from_string_default_with_base (s: STRING_8; base: INTEGER_32)
date_default_format_string`base'
require
s_exists: s /= Void
base_valid: base > 0 and (base \\ 100 = 0)
date_valid: date_valid_with_base (s, date_default_format_string, base)
make_from_string (s: STRING_8; code: STRING_8)
`code'
require
s_exists: s /= Void
c_exists: code /= Void
date_valid: date_valid (s, code)
make_from_string_with_base (s: STRING_8; code: STRING_8; base: INTEGER_32)
`code'`base'
require
s_exists: s /= Void
c_exists: code /= Void
base_valid: base > 0 and (base \\ 100 = 0)
date_valid: date_valid_with_base (s, code, base)
make_by_compact_date (c_d: INTEGER_32)
compact_date
require
c_d_valid: compact_date_valid (c_d)
ensure
compact_date_set: year | (month |<< 16) | (day |<< 24) = c_d
make_by_ordered_compact_date (c_d: INTEGER_32)
ordered_compact_date
require
c_d_valid: ordered_compact_date_valid (c_d)
ensure
ordered_compact_date_set: ordered_compact_date = c_d
feature
make (y, m, d: INTEGER_32)
yearmonthday`y'`m'`d'
require
correct_date: is_correct_date (y, m, d)
ensure
year_set: year = y
month_set: month = m
day_set: day = d
make_by_days (n: INTEGER_32)
`n'Origin
ensure
days_set: days = n
make_by_ordered_compact_date (c_d: INTEGER_32)
ordered_compact_date
require
c_d_valid: ordered_compact_date_valid (c_d)
ensure
ordered_compact_date_set: ordered_compact_date = c_d
make_day_month_year (d, m, y: INTEGER_32)
daymonthyear`d'`m'`y'
require
correct_date: is_correct_date (y, m, d)
ensure
year_set: year = y
month_set: month = m
day_set: day = d
make_from_string (s: STRING_8; code: STRING_8)
`code'
require
s_exists: s /= Void
c_exists: code /= Void
date_valid: date_valid (s, code)
make_from_string_default (s: STRING_8)
date_default_format_string
require
s_exists: s /= Void
date_valid: date_valid (s, date_default_format_string)
make_from_string_default_with_base (s: STRING_8; base: INTEGER_32)
date_default_format_string`base'
require
s_exists: s /= Void
base_valid: base > 0 and (base \\ 100 = 0)
date_valid: date_valid_with_base (s, date_default_format_string, base)
make_from_string_with_base (s: STRING_8; code: STRING_8; base: INTEGER_32)
`code'`base'
require
s_exists: s /= Void
c_exists: code /= Void
base_valid: base > 0 and (base \\ 100 = 0)
date_valid: date_valid_with_base (s, code, base)
make_month_day_year (m, d, y: INTEGER_32)
monthdayyear`m'`d'`y'
require
correct_date: is_correct_date (y, m, d)
ensure
year_set: year = y
month_set: month = m
day_set: day = d
make_now
make_now_utc
feature
date_default_format_string: STRING_8
DATE_CONSTANTS
date_time_tools: DATE_TIME_TOOLS
TIME_UTILITY
day: INTEGER_32
DATE_VALUE
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
generating_type: STRING_8
ANY
generator: STRING_8
ANY
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
month: INTEGER_32
DATE_VALUE
months_in_year: INTEGER_32 is 12
DATE_CONSTANTS
months_text: ARRAY [STRING_8]
DATE_CONSTANTS
ordered_compact_date: INTEGER_32
DATE_VALUE
origin: DATE
ensure ABSOLUTE
result_exists: Result /= Void
year: INTEGER_32
DATE_VALUE
feature
days: INTEGER_32
Origin
ensure
same_duration: Result = duration.day
duration: DATE_DURATION
Origin
require ABSOLUTE
True
ensure then
definite_result: Result.definite
duration_set: ((Current - origin).duration).is_equal (Result)
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'
COMPARABLE
require ANY
other_not_void: other /= Void
ensure ANY
symmetric: Result implies other.is_equal (Current)
consistent: standard_is_equal (other) implies Result
ensure then COMPARABLE
trichotomy: Result = (not (Current < other) and not (other < Current))
max (other: like Current): like Current
`other'
COMPARABLE
require COMPARABLE
other_exists: other /= Void
ensure COMPARABLE
current_if_not_smaller: Current >= other implies Result = Current
other_if_smaller: Current < other implies Result = other
min (other: like Current): like Current
`other'
COMPARABLE
require COMPARABLE
other_exists: other /= Void
ensure COMPARABLE
current_if_not_greater: Current <= other implies Result = Current
other_if_greater: Current > other implies Result = other
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)
three_way_comparison (other: like Current): INTEGER_32
`other'
COMPARABLE
require COMPARABLE
other_exists: other /= Void
ensure COMPARABLE
equal_zero: (Result = 0) = is_equal (other)
smaller_negative: (Result = -1) = (Current < other)
greater_positive: (Result = 1) = (Current > other)
infix "<" (other: like Current): BOOLEAN
`other'
require PART_COMPARABLE
other_exists: other /= Void
ensure then COMPARABLE
asymmetric: Result implies not (other < Current)
infix "<=" (other: like Current): BOOLEAN
`other'
COMPARABLE
require PART_COMPARABLE
other_exists: other /= Void
ensure then COMPARABLE
definition: Result = ((Current < other) or is_equal (other))
infix ">" (other: like Current): BOOLEAN
`other'
COMPARABLE
require PART_COMPARABLE
other_exists: other /= Void
ensure then COMPARABLE
definition: Result = (other < Current)
infix ">=" (other: like Current): BOOLEAN
`other'
COMPARABLE
require PART_COMPARABLE
other_exists: other /= Void
ensure then COMPARABLE
definition: Result = (other <= Current)
feature
conforms_to (other: ANY): BOOLEAN
`other'
ANY
require ANY
other_not_void: other /= Void
day_of_january_1st: INTEGER_32
ensure
day_of_the_week_definition: Result > 0 and then Result < 8
day_of_the_week: INTEGER_32
ensure
day_of_the_week_range: Result > 0 and then Result < 8
days_at_month: INTEGER_32
ensure
positive_result: Result >= 0
days_from (y: INTEGER_32): INTEGER_32
`y'
days_in_year: INTEGER_32
ensure
valid_result: (leap_year implies Result = days_in_leap_year) and then (not leap_year implies Result = days_in_non_leap_year)
is_leap_year (y: INTEGER_32): BOOLEAN
`y'
DATE_CONSTANTS
leap_year: BOOLEAN
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))
week_of_year: INTEGER_32
ensure
positive_result: Result >= 0
result_small_enough: Result < max_weeks_in_year
year_day: INTEGER_32
ensure
result_large_enough: Result >= 1
result_small_enough: Result <= days_in_year
feature
set_date (y, m, d: INTEGER_32)
year`y'month`m'day`d'
DATE_VALUE
require DATE_MEASUREMENT
d_large_enough: d >= 1
m_large_enough: m >= 1
m_small_enough: m <= months_in_year
d_small_enough: d <= days_in_i_th_month (m, y)
ensure DATE_MEASUREMENT
day_set: day = d
month_set: month = m
year_set: year = y
set_day (d: INTEGER_32)
day`d'
DATE_VALUE
require DATE_MEASUREMENT
d_large_enough: d >= 1
d_small_enough: d <= days_in_month
ensure DATE_MEASUREMENT
day_set: day = d
set_internal_ordered_compact_date (a_ordered_compact_date: like ordered_compact_date)
`a_ordered_compact_date'ordered_compact_date
DATE_VALUE
ensure DATE_VALUE
ordered_compact_date_set: ordered_compact_date = a_ordered_compact_date
set_month (m: INTEGER_32)
month`m'
DATE_VALUE
require DATE_MEASUREMENT
m_large_enough: m >= 1
m_small_enough: m <= months_in_year
d_small_enough: day <= days_in_i_th_month (m, year)
ensure DATE_MEASUREMENT
month_set: month = m
set_year (y: INTEGER_32)
year`y'
DATE_VALUE
require DATE_MEASUREMENT
can_not_cut_29th_feb: day <= days_in_i_th_month (month, y)
ensure DATE_MEASUREMENT
year_set: year = y
feature
to_date_time: DATE_TIME
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
add (d: DATE_DURATION)
`d'
`d'
day_add (d: INTEGER_32)
`d'
ensure
days_set: days = old days + d
day_back
ensure
days_set: days = old days - 1
day_forth
ensure
days_set: days = old days + 1
frozen default: like Current
ANY
frozen default_pointer: POINTER
`POINTER'
`p'default
`p'`POINTER'
ANY
default_rescue
ANY
frozen do_nothing
ANY
month_add (m: INTEGER_32)
`m'
month_back
month_forth
relative_duration (other: like Current): DATE_DURATION
`other'
require ABSOLUTE
other_exists: other /= Void
ensure ABSOLUTE
result_exists: Result /= Void
ensure then
exact_duration: (other + Result).is_equal (Current)
canonical_duration: Result.canonical (other)
origin_date_set: equal (Result.origin_date, other)
year_add (y: INTEGER_32)
`y'
ensure
year_set: year = old year + y
year_back
ensure
year_decreased: year = old year - 1
year_forth
ensure
year_increased: year = old year + 1
year_month_add (y, m: INTEGER_32)
`y'`m'
infix "+" (d: DATE_DURATION): DATE
`d'
ensure
result_exists: Result /= Void
definite_set: d.definite implies (Result - Current).duration.is_equal (d)
infix "-" (other: like Current): INTERVAL [DATE]
`other'
ABSOLUTE
require ABSOLUTE
other_exists: other /= Void
other_smaller_than_current: other <= Current
ensure ABSOLUTE
result_exists: Result /= Void
result_set: Result.start_bound.is_equal (other) and then Result.end_bound.is_equal (Current)
feature
correct_mismatch
Mismatch_information
DATE_VALUE
mismatch_information: MISMATCH_INFORMATION
MISMATCH_CORRECTOR
feature
formatted_out (s: STRING_8): STRING_8
`Current'
`s'
require
s_exists: s /= Void
io: STD_FILES
ANY
out: STRING_8
`Current'
date_default_format_string
print (some: ANY)
`some'
ANY
frozen tagged_out: STRING_8
ANYout
ANY
feature
operating_environment: OPERATING_ENVIRONMENT
ANY
feature
compact_date_valid (c_d: INTEGER_32): BOOLEAN
`c_d'
DATE_VALIDITY_CHECKER
date_valid (s: STRING_8; code_string: STRING_8): BOOLEAN
`s'`code_string'
DATE_VALIDITY_CHECKER
require DATE_VALIDITY_CHECKER
s_exists: s /= Void
code_exists: code_string /= Void
date_valid_default (s: STRING_8): BOOLEAN
`s'
date_default_format_string
DATE_VALIDITY_CHECKER
require DATE_VALIDITY_CHECKER
s_exists: s /= Void
date_valid_default_with_base (s: STRING_8; base: INTEGER_32): BOOLEAN
`s'
date_default_format_string
`base'
DATE_VALIDITY_CHECKER
require DATE_VALIDITY_CHECKER
s_exists: s /= Void
base_valid: base > 0 and (base \\ 100 = 0)
date_valid_with_base (s: STRING_8; code_string: STRING_8; base: INTEGER_32): BOOLEAN
`s'`code_string'
`base'
DATE_VALIDITY_CHECKER
require DATE_VALIDITY_CHECKER
s_exists: s /= Void
code_exists: code_string /= Void
base_valid: base > 0 and (base \\ 100 = 0)
is_correct_date (y, m, d: INTEGER_32): BOOLEAN
`y'`m'`d'
DATE_VALIDITY_CHECKER
ordered_compact_date_valid (c_d: INTEGER_32): BOOLEAN
`c_d'
DATE_VALIDITY_CHECKER
feature
days_in_month: INTEGER_32
DATE_MEASUREMENT
ensure DATE_MEASUREMENT
positive_result: Result > 0
invariant
day_large_enough: day >= 1
day_small_enough: day <= days_in_month
month_large_enough: month >= 1
month_small_enough: month <= months_in_year
year_small_enough: year <= 65535
year_non_negative: year >= 0
COMPARABLE
irreflexive_comparison: not (Current < Current)
ANY
reflexive_equality: standard_is_equal (Current)
reflexive_conformance: conforms_to (Current)
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