Class: When::CalendarNote

Inherits:
TM::ReferenceSystem show all
Defined in:
lib/when_exe/calendarnote.rb,
lib/when_exe/region/bahai.rb,
lib/when_exe/region/mayan.rb,
lib/when_exe/region/indian.rb,
lib/when_exe/region/chinese.rb,
lib/when_exe/region/martian.rb,
lib/when_exe/region/tibetan.rb,
lib/when_exe/ephemeris/notes.rb,
lib/when_exe/region/javanese.rb,
lib/when_exe/region/japanese/notes.rb,
lib/when_exe.rb

Overview

Ephemeris を用いる暦注

Defined Under Namespace

Modules: LabelAccess, NotesContainer Classes: Balinese, Christian, DarianWeek, DiscordianWeek, Enumerator, Ephemeris, HinduNote, HinduNoteDetailed, Japanese, JapaneseLuniSolarNote, JapaneseSolarNote, LunarPhases, LuniSolarPositions, NoteElement, Roman, ShireWeek, SolarTerms, Week, WorldWeek, Zoroastrian

Constant Summary collapse

CalendarDepend =

暦法によってイベントの動作を変えるか否か

false
Bahai = 
[['Bahai::YearName'], ['_m:Bahai::Month'], ['Common::Week']]
Mayan = 
[{},['Mayan#{?Epoch=Epoch}::Trecena', 'Mayan#{?Epoch=Epoch}::Tzolk\'in',
'Mayan#{?Epoch=Epoch}::Lords_of_the_Night', 'Mayan#{?Epoch=Epoch}::Haab\'']]
Yis = 
[['Yi::YearName'], ['_m:Calendar::Month'], ['Common::Week']]
Tibetan = 
[['Tibetan::干支'], ['_m:Calendar::Month'], ['Common::Week']]
Javanese = 
[['Javanese::Windu'], ['_m:Calendar::Month'],
['Javanese::Pasaran', 'Javanese::Paringkelan', 'Javanese::Week', 'Javanese::Wuku']]
Default = 
[['_m:Calendar::Month'], ['Common::Week']]
JulianDay = 
[['Common::Week', 'Common::干支']]
Chinese = 
[['Common::干支'], ['_m:Calendar::Month'], ['Common::Week', 'Common::干支']]

Constants included from Parts::Resource

Parts::Resource::ConstList, Parts::Resource::ConstTypes, Parts::Resource::IRIHeader, Parts::Resource::LabelProperty

Instance Attribute Summary collapse

Attributes inherited from TM::ReferenceSystem

#domain_of_validity, #position

Attributes inherited from BasicTypes::Object

#label

Attributes included from Parts::Resource

#_pool, #child, #keys, #locale, #namespace

Instance Method Summary collapse

Methods inherited from TM::ReferenceSystem

#domain, #name

Methods included from Parts::Resource

#[], #^, _abbreviation_to_iri, _decode, _encode, _extract_prefix, _instance, _instantiate, _parse, _path_with_prefix, _replace_tags, _setup_, _setup_info, _simplify_path, base_uri, #each, #hierarchy, #included?, #iri, #leaf?, #m17n, #map, #next, #parent, #prev, #registered?, root_dir

Methods included from Parts::Resource::Pool

#[], #[]=, #_pool, #_setup_, #pool_keys

Methods included from Parts::Resource::Synchronize

#synchronize

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class When::Parts::Resource

Instance Attribute Details

#event ⇒ String

Note:

イベント名の後ろに数字が使われている場合、数字部分以降はイベントメソッドの引数になります。SolarTermsクラスで ‘term180’ は、太陽黄経180度のイベントすなわち秋分を意味します。

デフォルトイベント名



217
218
219
 
# File 'lib/when_exe/calendarnote.rb', line 217

def event
  @event
end

Instance Method Details

#copy(event) ⇒ When::CalendarNote

デフォルトイベントの指定



226
227
228
229
230
 
# File 'lib/when_exe/calendarnote.rb', line 226

def copy(event)
  c = self.clone
  c.event = event
  c
end

#day ⇒ When::BasicTypes::M17n 




# File 'lib/when_exe/calendarnote.rb', line 385

#duration(event = @event) ⇒ When::TM::PeriodDuration

典型的なイベントの発生間隔



238
239
240
241
 
# File 'lib/when_exe/calendarnote.rb', line 238

def duration(event=@event)
  void, event, parameter = event.split(/^([^\d]+)/)
  send((event+'_delta').downcase.to_sym, parameter)
end

#enum_for(range, options = {}) ⇒ Enumerator #enum_for(first, direction = :forward, options = {}) ⇒ Enumerator Also known as: to_enum

Enumeratorの生成

Overloads:

  • #enum_for(range, options = {}) ⇒ Enumerator

    Options Hash (options):

    • :event (String) —

      イベント名(デフォルトは@event)

    • :count_limit (Integer) —

      繰り返し回数(デフォルトは指定なし)

  • #enum_for(first, direction = :forward, options = {}) ⇒ Enumerator

    Options Hash (options):

    • :event (String) —

      イベント名(デフォルトは@event)

    • :count_limit (Integer) —

      繰り返し回数(デフォルトは指定なし)



277
278
279
280
281
282
283
284
 
# File 'lib/when_exe/calendarnote.rb', line 277

def enum_for(*args)
  params  = args.dup
  options = params[-1].kind_of?(Hash) ? params.pop.dup : {}
  options[:event] ||= @event
  self.class::Enumerator.new(*(params[0].kind_of?(Range) ?
    [self, params[0],                        options] :
    [self, params[0], params[1] || :forward, options]))
end

#include?(date, event = @event) ⇒ Boolean

指定の日時が指定イベントに該当するか?



252
253
254
 
# File 'lib/when_exe/calendarnote.rb', line 252

def include?(date, event=@event)
  enum_for(date, :forward, event.downcase).next.include?(date)
end

#month ⇒ When::BasicTypes::M17n 




# File 'lib/when_exe/calendarnote.rb', line 381

#note?(date, options = {}) ⇒ Boolean

暦注の一致 or 不一致

Options Hash (options):

  • :value (暦注の値) —

    確認する暦注の値(または正規表現)

  • その他 (それぞれ) —

    #notes を参照



363
364
365
366
367
368
369
370
371
372
373
374
375
 
# File 'lib/when_exe/calendarnote.rb', line 363

def note?(date, options={})
  options = _find_note(options)    if options.kind_of?(String) || options.kind_of?(Regexp)
  pattern = options.delete(:value) if options.kind_of?(Hash)
  result  = notes(date, options)
  result.flatten!
  result.delete_if {|hash| hash.empty?}
  return false unless result.size > 0
  return true unless pattern
  result.each do |hash|
    return true if NotesContainer.verify(pattern, hash[:value])
  end
  return false
end

#notes(date, options = {}) ⇒ Array<Array<Hash>>

Note:

CalendarNoteオブジェクト生成時に _normalize メソッド内で @prime 変数を設定しておけば、本メソッドの :prime オプションで参照される。(Balinese#_normalize等参照)

Note:

暦注のビットアドレスは、暦注サブクラスのNotes定数の中の定義順序による。When::CalendarNote クラスの場合 new の引数とした暦注要素リストの定義順序による。ビットアドレスの値が 1 の暦注が計算対象となる。

Note:

戻り値の :value が When::TM::TemporalPosition の場合、その日時オブジェクトの events に暦注名の入った暦注に該当する日付である。(例) Christian クラス で easter を計算した場合、当該年の復活祭の日付オブジェクトが返る。

Note:

暦注サブクラスの場合、暦注要素が増えたり、:note の暦注要素の型が変わったりすることがある。

暦注の計算

Options Hash (options):

  • :indices (Integer) —

    Integerで指定した暦座標の暦注を計算

    When::DAY ( 0) - 日
    When::MONTH(-1) - 月
    When::YEAR (-2) - 年
  • :indices (Array<Integer>) —

    Integerで指定したすべて暦座標の暦注を計算

  • :indices (nil) —

    すべての暦座標の暦注を計算(デフォルト)

  • :notes (String) —

    計算する暦注名(日の暦注)

  • :notes (Integer) —

    計算する暦注のビット配列(日の暦注)

  • :notes (Array<Array<String>>) —

    計算する暦注名の Array の Array

  • :notes (Array<Integer>) —

    計算する暦注のビット配列の Array

  • :notes (:all) —

    すべての暦注を計算

  • :notes (:prime, nil) —

    @prime に登録した暦注を計算、@prime未登録なら :all と同じ(デフォルト)

  • :persistence (Hash) —

    ユリウス通日=>暦注計算結果を保持する永続オブジェクト

  • :conditions (Hash) —

    暦注計算の条件

    :location => 暦注計算の基準となる場所(String or When::Coordinates::Spatial)
    その他のキー => 個々の暦注クラスごとにその他のキーを使用できる
  • その他のキー (Hash) —

    date を When::TM::TemporalPosition に変換するために使用するsee TM::TemporalPosition._instance



332
333
334
335
336
337
338
339
340
341
342
343
344
345
 
# File 'lib/when_exe/calendarnote.rb', line 332

def notes(date, options={})
  dates, indices, notes, persistence, conditions, options = _parse_note(date, options)
  retrieved = NotesContainer.retrieve(persistence, date.to_i)
  return retrieved unless retrieved == false
  NotesContainer.register(indices.map {|i|
    next [] unless i <= date.precision
    _note_values(dates, notes[i-1], _all_keys[i-1], _elements[i-1]) do |dates, focused_notes, notes_hash|
      focused_notes.each do |note|
        notes_hash[note] ||= _note_element(note, i, conditions, dates)
      end
      notes_hash
    end
  }, persistence, date.to_i)
end

#year ⇒ When::BasicTypes::M17n 




# File 'lib/when_exe/calendarnote.rb', line 377