Class: Wareki::Date

Inherits:
Object
  • Object
show all
Defined in:
lib/wareki/date.rb

Overview

Wareki date handling class, main implementation.

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(era_name, era_year, month = 1, day = 1, is_leap_month = false) ⇒ Date

Returns a new instance of Date.

Raises:

  • (ArgumentError)


80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
# File 'lib/wareki/date.rb', line 80

def initialize(era_name, era_year, month = 1, day = 1, is_leap_month = false)
  raise ArgumentError, "Undefined era '#{era_name}'" if
    era_name.to_s != '' && era_name != '紀元前' && !ERA_BY_NAME[era_name]

  @month = month
  @day = day
  @is_leap_month = is_leap_month
  @era_name = era_name
  @era_year = era_year
  if era_name.to_s == '' || era_name == '西暦'
    @year = @era_year
  elsif era_name.to_s == '紀元前'
    @year = -@era_year
  elsif %w(皇紀 神武天皇即位紀元).include? era_name
    @year = era_year + IMPERIAL_START_YEAR
  else
    @year = ERA_BY_NAME[era_name].year + era_year - 1
  end
end

Instance Attribute Details

#dayObject

Returns the value of attribute day.



8
9
10
# File 'lib/wareki/date.rb', line 8

def day
  @day
end

#era_nameObject

Returns the value of attribute era_name.



8
9
10
# File 'lib/wareki/date.rb', line 8

def era_name
  @era_name
end

#era_yearObject

Returns the value of attribute era_year.



8
9
10
# File 'lib/wareki/date.rb', line 8

def era_year
  @era_year
end

#monthObject

Returns the value of attribute month.



8
9
10
# File 'lib/wareki/date.rb', line 8

def month
  @month
end

#yearObject

Returns the value of attribute year.



8
9
10
# File 'lib/wareki/date.rb', line 8

def year
  @year
end

Class Method Details

._check_invalid_date(era, year, month, day) ⇒ Object



14
15
16
17
18
19
20
21
22
# File 'lib/wareki/date.rb', line 14

def self._check_invalid_date(era, year, month, day)
  month == 12 or return true
  day > 2 or return true
  (era == '明治' && year == 5 ||
   %w(皇紀 神武天皇即位紀元).member?(era) &&
   year == GREGORIAN_START_YEAR - IMPERIAL_START_YEAR - 1) and
    return false
  true
end

._parse(str) ⇒ Object



24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
# File 'lib/wareki/date.rb', line 24

def self._parse(str)
  match = REGEX.match(str.to_s.gsub(/[[:space:]]/, '')) or
    raise ArgumentError, "Invaild Date: #{str}"
  era = match[:era_name]
  (year = Kansuji.k2i(match[:year])) > 0 or
    raise ArgumentError, "Invalid year: #{str}"
  month = day = 1

  era.to_s != '' && era.to_s != '紀元前' && !ERA_BY_NAME[era] and
    raise ArgumentError, "Date parse failed: Invalid era name '#{match[:era_name]}'"

  if match[:month]
    month = Kansuji.k2i(match[:month])
  elsif match[:alt_month]
    month = Utils.alt_month_name_to_i(match[:alt_month])
  end

  month > 12 || month < 1 and
    raise ArgumentError, "Invalid month: #{str}"

  if match[:day]
    if match[:day] == '晦'
      day = Utils.last_day_of_month(ERA_BY_NAME[era].year + year - 1, month, match[:is_leap])
    else
      day = Kansuji.k2i(match[:day])
    end
  end

  _check_invalid_date(era, year, month, day) or
    raise ArgumentError, "Invaild Date: #{str}"

  {era: era, year: year, month: month, day: day, is_leap: !!match[:is_leap]}
end

.date(date) ⇒ Object



72
73
74
# File 'lib/wareki/date.rb', line 72

def self.date(date)
  jd(date.jd)
end

.imperial(year, month = 1, day = 1, is_leap_month = false) ⇒ Object



76
77
78
# File 'lib/wareki/date.rb', line 76

def self.imperial(year, month = 1, day = 1, is_leap_month = false)
  new('皇紀', year, month, day, is_leap_month)
end

.jd(d) ⇒ Object



63
64
65
66
67
68
69
70
# File 'lib/wareki/date.rb', line 63

def self.jd(d)
  era = Utils.find_era(d)
  era or raise UnsupportedDateRange, "Cannot find era for date #{d.inspect}"
  year, month, day, is_leap = Utils.find_date_ary(d)
  obj = new(era.name, year - era.year + 1, month, day, is_leap)
  obj.__set_jd(d)
  obj
end

.parse(str) ⇒ Object



58
59
60
61
# File 'lib/wareki/date.rb', line 58

def self.parse(str)
  di = _parse(str)
  new(di[:era], di[:year], di[:month], di[:day], di[:is_leap])
end

.todayObject



10
11
12
# File 'lib/wareki/date.rb', line 10

def self.today
  jd(::Date.today.jd)
end

Instance Method Details

#+(other) ⇒ Object



237
238
239
# File 'lib/wareki/date.rb', line 237

def +(other)
  self.class.jd jd + _to_jd_for_calc(other)
end

#-(other) ⇒ Object



233
234
235
# File 'lib/wareki/date.rb', line 233

def -(other)
  self.class.jd jd - _to_jd_for_calc(other)
end

#===(other) ⇒ Object



224
225
226
227
228
229
230
231
# File 'lib/wareki/date.rb', line 224

def ===(other)
  begin
    other.jd == jd or return false
  rescue NoMethodError, NotImplementedError
    return false
  end
  true
end

#__set_jd(v) ⇒ Object



116
117
118
# File 'lib/wareki/date.rb', line 116

def __set_jd(v)
  @jd = v
end

#_to_jd_for_calc(other) ⇒ Object



241
242
243
244
245
246
247
# File 'lib/wareki/date.rb', line 241

def _to_jd_for_calc(other)
  other.class.to_s == 'ActiveSupport::Duration' and
    raise NotImplementedError, 'Date calcration with ActiveSupport::Duration currently is not supported. Please use numeric.'
  other.respond_to?(:to_date) and other = other.to_date
  other.respond_to?(:jd) and other = other.jd
  other
end

#eql?(other) ⇒ Boolean Also known as: ==

Returns:

  • (Boolean)


212
213
214
215
216
217
218
219
220
221
# File 'lib/wareki/date.rb', line 212

def eql?(other)
  begin
    i[year month day era_year era_name leap_month?].each do |attr|
      other.public_send(attr) == public_send(attr) or return false
    end
  rescue NoMethodError, NotImplementedError
    return false
  end
  true
end

#format(key) ⇒ Object



160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
# File 'lib/wareki/date.rb', line 160

def format(key)
  case key.to_sym
  when :e  then era_name
  when :g  then era_name.to_s == '' ? '' : era_year
  when :G  then era_name.to_s == '' ? '' : Kansuji.i2z(era_year)
  when :Gk then era_name.to_s == '' ? '' : Kansuji.i2k(era_year)
  when :GK
    if era_name.to_s == ''
      ''
    elsif era_year == 1
      '元'
    else
      Kansuji.i2k(era_year)
    end
  when :o  then year
  when :O  then Kansuji.i2z(year)
  when :Ok then Kansuji.i2k(year)
  when :i  then imperial_year
  when :I  then Kansuji.i2z(imperial_year)
  when :Ik then Kansuji.i2k(imperial_year)
  when :s  then month
  when :S  then Kansuji.i2z(month)
  when :Sk then Kansuji.i2k(month)
  when :SK then Utils.alt_month_name(month)
  when :l  then leap_month? ? "'" : ''
  when :L  then leap_month? ? '’' : ''
  when :Lk then leap_month? ? '閏' : ''
  when :d  then day
  when :D  then Kansuji.i2z(day)
  when :Dk then Kansuji.i2k(day)
  when :DK
    if month == 1 && !leap_month? && day == 1
      '元'
    elsif day == 1
      '朔'
    elsif day == Utils.last_day_of_month(year, month, leap_month?)
      '晦'
    else
      Kansuji.i2k(day)
    end
  when :m  then "#{format(:s)}#{format(:l)}"
  when :M  then "#{format(:Lk)}#{format(:S)}"
  when :Mk then "#{format(:Lk)}#{format(:Sk)}"
  when :y  then "#{format(:e)}#{format(:g)}"
  when :Y  then "#{format(:e)}#{format(:G)}"
  when :Yk then "#{format(:e)}#{format(:Gk)}"
  when :YK then "#{format(:e)}#{format(:GK)}"
  when :f  then "#{format(:e)}#{format(:g)}年#{format(:s)}#{format(:l)}月#{format(:d)}日"
  when :F  then "#{format(:e)}#{format(:GK)}年#{format(:Lk)}#{format(:Sk)}月#{format(:Dk)}日"
  end
end

#imperial_yearObject



100
101
102
# File 'lib/wareki/date.rb', line 100

def imperial_year
  @year - IMPERIAL_START_YEAR
end

#imperial_year=(v) ⇒ Object



104
105
106
# File 'lib/wareki/date.rb', line 104

def imperial_year=(v)
  @year = v - IMPERIAL_START_YEAR
end

#jdObject



131
132
133
134
135
136
137
138
139
140
141
142
143
# File 'lib/wareki/date.rb', line 131

def jd
  @jd and return @jd

  ['', '西暦', '紀元前'].include?(@era_name) and
    return @jd = ::Date.new(@year, month, day, ::Date::ITALY).jd

  @year >= GREGORIAN_START_YEAR and
    return @jd = ::Date.new(@year, month, day, ::Date::GREGORIAN).jd

  yobj = YEAR_BY_NUM[@year] or
    raise UnsupportedDateRange, "Cannot convert to jd #{inspect}"
  @jd = yobj.month_starts[month_index] + day - 1
end

#leap_month=(v) ⇒ Object



112
113
114
# File 'lib/wareki/date.rb', line 112

def leap_month=(v)
  @is_leap_month = v
end

#leap_month?Boolean

Returns:

  • (Boolean)


108
109
110
# File 'lib/wareki/date.rb', line 108

def leap_month?
  !!@is_leap_month
end

#month_indexObject



120
121
122
123
124
125
126
127
128
129
# File 'lib/wareki/date.rb', line 120

def month_index
  return month - 1 if
    ['', '西暦', '紀元前'].include?(@era_name) || @year >= GREGORIAN_START_YEAR

  yobj = YEAR_BY_NUM[@year] or
    raise UnsupportedDateRange, "Cannot get year info of #{inspect}"
  idx = month - 1
  idx += 1 if leap_month? || yobj.leap_month && month > yobj.leap_month
  idx
end

#strftime(format_str = '%JF') ⇒ Object



153
154
155
156
157
158
# File 'lib/wareki/date.rb', line 153

def strftime(format_str = '%JF')
  ret = format_str.to_str.gsub(/%J([fFyYegGoOiImMsSlLdD][kK]?)/) { format($1) || $& }
  ret.index('%') or return ret
  d = to_date
  d.respond_to?(:_wareki_strftime_orig) ? d._wareki_strftime_orig(ret) : d.strftime(ret)
end

#to_date(start = ::Date::ITALY) ⇒ Object



145
146
147
# File 'lib/wareki/date.rb', line 145

def to_date(start = ::Date::ITALY)
  ::Date.jd(jd, start)
end

#to_timeObject



149
150
151
# File 'lib/wareki/date.rb', line 149

def to_time
  to_date.to_time
end