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)


88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
# File 'lib/wareki/date.rb', line 88

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.



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

def day
  @day
end

#era_nameObject

Returns the value of attribute era_name.



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

def era_name
  @era_name
end

#era_yearObject

Returns the value of attribute era_year.



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

def era_year
  @era_year
end

#monthObject

Returns the value of attribute month.



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

def month
  @month
end

#yearObject

Returns the value of attribute year.



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

def year
  @year
end

Class Method Details

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



17
18
19
20
21
22
23
24
25
# File 'lib/wareki/date.rb', line 17

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



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
57
58
59
60
61
62
63
64
# File 'lib/wareki/date.rb', line 27

def self._parse(str)
  str = str.to_s.gsub(/[[:space:]]/, '')
  match = (!str.empty? && REGEX.match(str)) or
    raise ArgumentError, "Invaild Date: #{str}"
  era = match[:era_name]
  if (era.nil? || era == '') && match[:year].nil?
    year = Date.today.year
  else
    (year = Utils.k2i(match[:year])) > 0 or
      raise ArgumentError, "Invalid year: #{str}"
  end
  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 = Utils.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 = Utils.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



80
81
82
# File 'lib/wareki/date.rb', line 80

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

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



84
85
86
# File 'lib/wareki/date.rb', line 84

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

.jd(d) ⇒ Object



71
72
73
74
75
76
77
78
# File 'lib/wareki/date.rb', line 71

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



66
67
68
69
# File 'lib/wareki/date.rb', line 66

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

.todayObject



13
14
15
# File 'lib/wareki/date.rb', line 13

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

Instance Method Details

#+(other) ⇒ Object



245
246
247
# File 'lib/wareki/date.rb', line 245

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

#-(other) ⇒ Object



241
242
243
# File 'lib/wareki/date.rb', line 241

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

#===(other) ⇒ Object



232
233
234
235
236
237
238
239
# File 'lib/wareki/date.rb', line 232

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

#__set_jd(v) ⇒ Object



124
125
126
# File 'lib/wareki/date.rb', line 124

def __set_jd(v)
  @jd = v
end

#_to_jd_for_calc(other) ⇒ Object



249
250
251
252
253
254
255
# File 'lib/wareki/date.rb', line 249

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)


220
221
222
223
224
225
226
227
228
229
# File 'lib/wareki/date.rb', line 220

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



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
211
212
213
214
215
216
217
218
# File 'lib/wareki/date.rb', line 168

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 == '' ? '' : Utils.i2z(era_year)
  when :Gk then era_name.to_s == '' ? '' : YaKansuji.to_kan(era_year, :simple)
  when :GK
    if era_name.to_s == ''
      ''
    elsif era_year == 1
      '元'
    else
      YaKansuji.to_kan(era_year, :simple)
    end
  when :o  then year
  when :O  then Utils.i2z(year)
  when :Ok then YaKansuji.to_kan(year, :simple)
  when :i  then imperial_year
  when :I  then Utils.i2z(imperial_year)
  when :Ik then YaKansuji.to_kan(imperial_year, :simple)
  when :s  then month
  when :S  then Utils.i2z(month)
  when :Sk then YaKansuji.to_kan(month, :simple)
  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 Utils.i2z(day)
  when :Dk then YaKansuji.to_kan(day, :simple)
  when :DK
    if month == 1 && !leap_month? && day == 1
      '元'
    elsif day == 1
      '朔'
    elsif day == Utils.last_day_of_month(year, month, leap_month?)
      '晦'
    else
      YaKansuji.to_kan(day, :simple)
    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



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

def imperial_year
  @year - IMPERIAL_START_YEAR
end

#imperial_year=(v) ⇒ Object



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

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

#jdObject



139
140
141
142
143
144
145
146
147
148
149
150
151
# File 'lib/wareki/date.rb', line 139

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



120
121
122
# File 'lib/wareki/date.rb', line 120

def leap_month=(v)
  @is_leap_month = v
end

#leap_month?Boolean

Returns:

  • (Boolean)


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

def leap_month?
  !!@is_leap_month
end

#month_indexObject



128
129
130
131
132
133
134
135
136
137
# File 'lib/wareki/date.rb', line 128

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



161
162
163
164
165
166
# File 'lib/wareki/date.rb', line 161

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



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

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

#to_timeObject



157
158
159
# File 'lib/wareki/date.rb', line 157

def to_time
  to_date.to_time
end