Module: When

Included in:
TM::PeriodDuration, TM::TemporalPosition, TM::TemporalPosition, V::Event::Enumerator
Defined in:
lib/when_exe.rb,
lib/when_exe/events.rb,
lib/when_exe/inspect.rb,
lib/when_exe/version.rb,
lib/when_exe/namespace.rb,
lib/when_exe/basictypes.rb,
lib/when_exe/linkeddata.rb,
lib/when_exe/locales/af.rb,
lib/when_exe/locales/ar.rb,
lib/when_exe/locales/az.rb,
lib/when_exe/locales/bg.rb,
lib/when_exe/locales/bn.rb,
lib/when_exe/locales/bs.rb,
lib/when_exe/locales/ca.rb,
lib/when_exe/locales/cs.rb,
lib/when_exe/locales/cy.rb,
lib/when_exe/locales/da.rb,
lib/when_exe/locales/de.rb,
lib/when_exe/locales/el.rb,
lib/when_exe/locales/en.rb,
lib/when_exe/locales/eo.rb,
lib/when_exe/locales/es.rb,
lib/when_exe/locales/et.rb,
lib/when_exe/locales/eu.rb,
lib/when_exe/locales/fa.rb,
lib/when_exe/locales/fi.rb,
lib/when_exe/locales/fr.rb,
lib/when_exe/locales/gl.rb,
lib/when_exe/locales/he.rb,
lib/when_exe/locales/hi.rb,
lib/when_exe/locales/hr.rb,
lib/when_exe/locales/hu.rb,
lib/when_exe/locales/id.rb,
lib/when_exe/locales/is.rb,
lib/when_exe/locales/it.rb,
lib/when_exe/locales/ja.rb,
lib/when_exe/locales/kn.rb,
lib/when_exe/locales/ko.rb,
lib/when_exe/locales/lo.rb,
lib/when_exe/locales/lt.rb,
lib/when_exe/locales/lv.rb,
lib/when_exe/locales/mk.rb,
lib/when_exe/locales/mn.rb,
lib/when_exe/locales/ms.rb,
lib/when_exe/locales/nb.rb,
lib/when_exe/locales/ne.rb,
lib/when_exe/locales/nl.rb,
lib/when_exe/locales/nn.rb,
lib/when_exe/locales/or.rb,
lib/when_exe/locales/pl.rb,
lib/when_exe/locales/pt.rb,
lib/when_exe/locales/rm.rb,
lib/when_exe/locales/ro.rb,
lib/when_exe/locales/ru.rb,
lib/when_exe/locales/sk.rb,
lib/when_exe/locales/sl.rb,
lib/when_exe/locales/sr.rb,
lib/when_exe/locales/sv.rb,
lib/when_exe/locales/sw.rb,
lib/when_exe/locales/ta.rb,
lib/when_exe/locales/th.rb,
lib/when_exe/locales/tl.rb,
lib/when_exe/locales/tr.rb,
lib/when_exe/locales/uk.rb,
lib/when_exe/locales/ur.rb,
lib/when_exe/locales/uz.rb,
lib/when_exe/locales/vi.rb,
lib/when_exe/locales/wo.rb,
lib/when_exe/locales/zh.rb,
lib/when_exe/region/dee.rb,
lib/when_exe/region/pax.rb,
lib/when_exe/tmduration.rb,
lib/when_exe/locales/akt.rb,
lib/when_exe/region/m17n.rb,
lib/when_exe/region/pope.rb,
lib/when_exe/region/thai.rb,
lib/when_exe/region/yerm.rb,
lib/when_exe/calendarnote.rb,
lib/when_exe/locales/iast.rb,
lib/when_exe/region/bahai.rb,
lib/when_exe/region/mayan.rb,
lib/when_exe/region/roman.rb,
lib/when_exe/region/shire.rb,
lib/when_exe/region/world.rb,
lib/when_exe/ephemeris/sun.rb,
lib/when_exe/locales/de_AT.rb,
lib/when_exe/locales/de_CH.rb,
lib/when_exe/locales/en_AU.rb,
lib/when_exe/locales/en_CA.rb,
lib/when_exe/locales/en_GB.rb,
lib/when_exe/locales/en_IE.rb,
lib/when_exe/locales/en_IN.rb,
lib/when_exe/locales/en_NZ.rb,
lib/when_exe/locales/en_US.rb,
lib/when_exe/locales/en_ZA.rb,
lib/when_exe/locales/es_AR.rb,
lib/when_exe/locales/es_CL.rb,
lib/when_exe/locales/es_CO.rb,
lib/when_exe/locales/es_CR.rb,
lib/when_exe/locales/es_EC.rb,
lib/when_exe/locales/es_MX.rb,
lib/when_exe/locales/es_PA.rb,
lib/when_exe/locales/es_PE.rb,
lib/when_exe/locales/es_US.rb,
lib/when_exe/locales/es_VE.rb,
lib/when_exe/locales/fr_CA.rb,
lib/when_exe/locales/fr_CH.rb,
lib/when_exe/locales/hi_IN.rb,
lib/when_exe/locales/it_CH.rb,
lib/when_exe/locales/links.rb,
lib/when_exe/locales/pt_BR.rb,
lib/when_exe/locales/zh_CN.rb,
lib/when_exe/locales/zh_HK.rb,
lib/when_exe/locales/zh_TW.rb,
lib/when_exe/region/coptic.rb,
lib/when_exe/region/french.rb,
lib/when_exe/region/indian.rb,
lib/when_exe/region/jewish.rb,
lib/when_exe/region/korean.rb,
lib/when_exe/region/ryukyu.rb,
lib/when_exe/ephemeris/moon.rb,
lib/when_exe/locales/es_419.rb,
lib/when_exe/locales/locale.rb,
lib/when_exe/locales/zh_YUE.rb,
lib/when_exe/region/chinese.rb,
lib/when_exe/region/goddess.rb,
lib/when_exe/region/iranian.rb,
lib/when_exe/region/islamic.rb,
lib/when_exe/region/martian.rb,
lib/when_exe/region/tibetan.rb,
lib/when_exe/region/armenian.rb,
lib/when_exe/region/balinese.rb,
lib/when_exe/region/japanese.rb,
lib/when_exe/region/javanese.rb,
lib/when_exe/region/symmetry.rb,
lib/when_exe/region/weekdate.rb,
lib/when_exe/locales/autoload.rb,
lib/when_exe/mini_application.rb,
lib/when_exe/region/christian.rb,
lib/when_exe/ephemeris/planets.rb,
lib/when_exe/parts/method_cash.rb,
lib/when_exe/region/babylonian.rb,
lib/when_exe/region/discordian.rb,
lib/when_exe/region/east_asian.rb,
lib/when_exe/region/positivist.rb,
lib/when_exe/region/vietnamese.rb,
lib/when_exe/region/hanke_henry.rb,
lib/when_exe/region/tranquility.rb,
lib/when_exe/region/zoroastrian.rb,
lib/when_exe/region/world_season.rb,
lib/when_exe/region/chinese/notes.rb,
lib/when_exe/region/chinese/twins.rb,
lib/when_exe/region/saudi_arabian.rb,
lib/when_exe/region/chinese/epochs.rb,
lib/when_exe/region/japanese/twins.rb,
lib/when_exe/region/japanese/epochs.rb,
lib/when_exe/region/chinese/calendars.rb,
lib/when_exe/region/japanese/calendars.rb,
lib/when_exe/region/international_fixed.rb,
lib/when_exe/locales/encoding_conversion.rb,
lib/when_exe/region/vanishing_leprechaun.rb,
lib/when_exe/locales/transliteration_table.rb

Overview

Copyright © 2014 Takashi SUGA

You may use and/or modify this file according to the license described in the LICENSE.txt file included in this archive.

Defined Under Namespace

Modules: BasicTypes, CalendarTypes, Coordinates, EX, EncodingConversion, Ephemeris, Events, GoogleAPI, Locale, Namespace, Parts, RS, TM, TimeStandard, V Classes: CalendarNote

Constant Summary collapse

SourceURI =

when_exe 用 International Resource Identifier

ENV["WHEN_EXE_BASE_URI"] || "http://hosi.org/When/"
RootDir =

ルートディレクトリ(デフォルトでは lib の親ディレクトリ

ENV["WHEN_EXE_ROOT_DIR"] || File.dirname(__FILE__).sub(/\/[^\/]*\z/,'')
PT1S =

1 second period duration

TM::PeriodDuration.new(nil,[0,0,0,1])
PT1M =

1 minute period duration

TM::PeriodDuration.new(nil,[0,0,1,0])
PT1H =

1 hour period duration

TM::PeriodDuration.new(nil,[0,1,0,0])
P1D =

1 day period duration

TM::PeriodDuration.new([0,0,1])
P1W =

1 week period duration

TM::PeriodDuration.new([0,0,7])
P1M =

1 month period duration

TM::PeriodDuration.new([0,1,0])
P1Y =

1 year period duration

TM::PeriodDuration.new([1,0,0])
TimeValue =

kind of When::TM::Position or When::TM::TemporalPosition

TM::IndeterminateValue
Week =

7 days week residue

When::Parts::Resource._instance('_co:Common::Week')
Month =

Gregorian months

When::Parts::Resource._instance('_m:Calendar::Month')
PlusInfinity =

+ ∞

TM::TemporalPosition.new({:indeterminated_position=>TimeValue::Max})
MinusInfinity =

  • ∞

TM::TemporalPosition.new({:indeterminated_position=>TimeValue::Min})
UTF8 =

UTF-8 encoding

'.UTF-8'
W31J =

Windows-31J encoding

'.Windows-31J'
EUCJP =

eucJP encoding

'.eucJP'
VERSION = 
"0.5.0"
YEARS = 
"(C) 2011-2021"
AUTHOR = 
"Takashi SUGA"
"#{YEARS} #{AUTHOR}"
CENTURY =

分解能定数

-4
DECADE = 
-3
YEAR = 
-2
MONTH = 
-1
WEEK = 
-0.5
DAY = 
0
HOUR = 
1
MINUTE = 
2
SECOND = 
3
STRING = 
5
SYSTEM = 
(Float::MANT_DIG*0.3).to_i

Class Attribute Summary collapse

Class Method Summary collapse

Class Attribute Details

.logger ⇒ Logger

Logger オブジェクト

Returns:

  • (Logger) 


49
50
51
 
# File 'lib/when_exe.rb', line 49

def logger
  @logger
end

.multi_thread ⇒ Boolean (readonly)

マルチスレッド対応の場合 true

Returns:

  • (Boolean) 


42
43
44
 
# File 'lib/when_exe.rb', line 42

def multi_thread
  @multi_thread
end

Class Method Details

._const_missing ⇒ Object 



134
 
# File 'lib/when_exe.rb', line 134

alias :_const_missing :const_missing

._define_common_calendar_types(list = %w(UTC Gregorian Julian Civil))) ⇒ Object

When 直下に定数として定義する時法・暦法(明示的的追加)



124
125
126
127
128
129
130
131
132
 
# File 'lib/when_exe.rb', line 124

def _define_common_calendar_types(list=%w(UTC Gregorian Julian Civil))
  list.each do |calendar|
    resource = Parts::Resource._instance(calendar, '_c:')
    Parts::Resource.synchronize do
      Parts::Resource::ConstList << calendar
      const_set(calendar, resource)
    end
  end
end

._setup_(options = {}) ⇒ void

Note:

本メソッドでマルチスレッド対応の管理変数の初期化を行っている。 このため、本メソッド自体および本メソッドから呼んでいる各クラスの setup メソッドはスレッドセーフでない。

This method returns an undefined value.

Initializations

Parameters:

  • options (Hash) (defaults to: {}) —

    以下の通り

Options Hash (options):

  • :local (When::Parts::Timezone::Base) —

    デフォルトの地方時

  • :location (When::Coordinates::Spatial) —

    デフォルトの空間位置

  • :until (When::TM::IntervalLength) —

    V::Event::Enumerator の until

  • :alias (Hash{String=>String}) —

    Locale の読替パターン ({ 読替前のlocale=>読替後のlocale })

  • :namespace_format (Hash{String=>String}) —

    名前空間定義の省略時に名前空間生成に用いる書式

  • :unification (Hash{String=>String}) —

    漢字の包摂パターン ({ 包摂前の文字列=>包摂後の文字列 })

  • :wikipedia_interval (Numeric) —

    Wikipedia の連続的な参照を抑制するための遅延時間/秒

  • :order (Array<String>) —

    CalendarEra の検索順序 ([ IRI of When::TM::CalendarEra ])

  • :format (Hash{String=>Array, String}) —

    strftime で用いる記号の定義 ({ 記号=>[ 書式,項目名 ] or 記号列 })

  • :table_off (false, nil) —

    高精度テーブル使用の指定 - 使用する

  • :table_off (true) —

    高精度テーブル使用の指定 - 使用しない

  • :leap_seconds (Array<Array>) —

    閏秒の挿入記録 ([ [JD, TAI-UTC, (MJD, OFFSET)] ])

  • :base_uri (String) —

    Base URI for When_exe Resources (Default When::SourceURI)

  • :additional_namespaces (Hash<String=>String>) —

    User defined namespaces (Default {})

  • :root_dir (String) —

    Root Directory for When_exe Resources Cash data (Default When::RootDir)

  • :leave_const (Boolean) —

    If true, leave Constants of When module defined

  • :direct (Boolean) —

    ‘_’ で終わるメソッドをキャッシュせずに毎回計算するか否か

  • :escape (Hash{Symbol=>boolean}) —

    毎回 method_missing を発生させるメソッドを true にする

  • :escape (false, nil) —

    to_str, to_ary, to_hash のみ毎回 method_missing を発生させる

  • :escape (true) —

    すべて毎回 method_missing を発生させる

  • :multi_thread (Boolean) —

    マルチスレッド対応 (true: 対応, false/nil: 非対応)

  • :logger (Logger) —

    Logger オブジェクト



84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
 
# File 'lib/when_exe.rb', line 84

def _setup_(options={})
  @multi_thread = options[:multi_thread]
  @logger       = options[:logger]
  Parts::MethodCash._setup_(options)
  Parts::Resource._setup_(options)
  Locale._setup_(options)
  Coordinates::Spatial._setup_(options[:location])
  TM::CalendarEra._setup_(options[:order])
  TM::Calendar._setup_
  TM::Clock._setup_(options[:local])
  TM::TemporalPosition._setup_(options[:format])
  CalendarNote::LuniSolarPositions._setup_(options[:table_off])
  V::Event._setup_(options[:until])
  V::Timezone._setup_
  Parts::Timezone._setup_
  TimeStandard._setup_(options[:leap_seconds])
end

._setup_info ⇒ Hash

設定情報を取得する

Returns:

  • (Hash) —

    設定情報



106
107
108
109
110
111
112
113
114
115
116
117
118
 
# File 'lib/when_exe.rb', line 106

def _setup_info
  {:multi_thread => @multi_thread}.
  update(Parts::MethodCash._setup_info).
  update(Parts::Resource._setup_info).
  update(Locale._setup_info).
  update(Coordinates::Spatial._setup_info).
  update(TM::CalendarEra._setup_info).
  update(TM::Clock._setup_info).
  update(TM::TemporalPosition._setup_info).
  update(CalendarNote::LuniSolarPositions._setup_info).
  update(V::Event._setup_info).
  update(TimeStandard._setup_info)
end

.at(time, options = {}) ⇒ When::TM::DateAndTime

指定日時に対応する When::TM::TemporalPosition の生成 (When::TM::DateAndTime of specified Time)

Parameters:

  • time (::Time) —

    変換元の日時のTimeオブジェクト

  • time (Float) —

    1970-01-01T00:00:00Z からの経過秒数

  • options (Hash) (defaults to: {}) —

    暦法や時法などの指定

Returns:

See Also:



645
646
647
648
649
650
651
652
653
654
655
656
 
# File 'lib/when_exe.rb', line 645

def at(time, options={})
  options = options._attr if options.kind_of?(TM::TemporalPosition)
  options[:frame] ||= 'Gregorian'
  options[:frame]   = Resource(options[:frame], '_c:') if options[:frame].kind_of?(String)
  options[:clock] ||= Clock(time.utc_offset) if time.kind_of?(::Time)
  jdt  = TM::JulianDate.universal_time(time.to_f * TM::IntervalLength::SECOND, {:frame=>TM::Clock.get_clock(options)})
  options[:clock]   = jdt.frame
  date = options[:frame].jul_trans(jdt, options)
  date = TM::CalDate.new(date.cal_date, options) if options[:precision] &&
                                                    options[:precision] <= DAY
  return date
end

.Border(border) ⇒ When::Coordinates::Border

When::Coordinates::Border の生成/参照

Parameters:

  • border (String) —

    年/日境界を表す文字列

Returns:



887
888
889
890
891
892
893
894
895
896
897
 
# File 'lib/when_exe.rb', line 887

def Border(border)
  case border
  when Coordinates::Border ; return border
  when /\([-\d]+?\)/       ; border = "_co:MultiBorder?borders=#{border}"
  when /\A[^A-Z_]/i        ; border = "_co:Border?border=#{border}"
  end

  Parts::Resource._instance(border, '_co:') do |iri|
    Coordinates::CalendarBorder.send(:_behalf_of, iri)
  end
end

.Calendar(calendar) ⇒ When::TM::Calendar

When::TM::Calendar の生成/参照

Parameters:

  • calendar (String) —

    暦法を表す文字列

Returns:



737
738
739
 
# File 'lib/when_exe.rb', line 737

def Calendar(calendar)
  Parts::Resource._instance(calendar, '_c:')
end

.CalendarEra(era) ⇒ When::TM::CalendarEra

When::TM::CalendarEra の生成/参照

Parameters:

  • era (String) —

    暦年代を表す文字列

Returns:



757
758
759
760
761
 
# File 'lib/when_exe.rb', line 757

def CalendarEra(era)
  Parts::Resource._instance(era, '_e:') do |iri|
    TM::CalendarEra.send(:_behalf_of, iri)
  end
end

.CalendarNote(note) ⇒ When::CalendarNote

When::CalendarNote の生成/参照

Parameters:

  • note (String) —

    暦注リストを表す文字列

Returns:



747
748
749
 
# File 'lib/when_exe.rb', line 747

def CalendarNote(note)
  Parts::Resource._instance(note, '_n:')
end

.client(server, port, query) ⇒ JSON

Note:

mini_application

マイクロ・クライアントを実行する

Parameters:

  • server (String) —

    マイクロ・サーバのアドレス

  • port (#to_i) —

    つなぐポート番号

  • query (String) —

    問い合わせ文字列

Returns:

  • (JSON) —

    応答



96
97
98
99
100
101
102
103
 
# File 'lib/when_exe/mini_application.rb', line 96

def client(server, port, query)
  TCPSocket.open(server, port.to_i) do |socket|
    socket.puts(query)
    results = JSON.parse(socket.gets.force_encoding("UTF-8"))
    results = Hash[*results.flatten(1)] if results[0].kind_of?(Array)
    _to_symbol(results)
  end
end

.Clock(clock) ⇒ When::Parts::Timezone::Base

When::TM::Clock の生成/参照

Parameters:

  • clock (When::Parts::Timezone::Base) —

    なにもせず clock をそのまま返す

  • clock (String) —

    時法を表す文字列

  • clock (Numeric) —

    秒を単位として表した時差(東経側を + とする)

Returns:



805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
 
# File 'lib/when_exe.rb', line 805

def Clock(clock)
  case clock
  when Parts::Timezone::Base             ; return clock
  when 'Z', 0                            ; return UTC
  when Numeric                           ; return Parts::Resource._instance("_tm:Clock?label=" + TM::Clock.to_hms(clock))
  when /\A#{CalendarTypes::TimeSystems}/ ; return Parts::Resource._instance('_c:' + clock)
  when String                            ;
  else                                   ; raise TypeError, "Invalid Type: #{clock.class}"
  end
  c    = TM::Clock[clock] || V::Timezone[clock]
  return c if c
  clock, options = clock.split('?')
  hms  = TM::Clock.to_hms(clock)
  return Parts::Timezone[clock] unless hms
  iri  = "_tm:Clock?label=" + hms
  iri += "&" + options if options
  Parts::Resource._instance(iri)
end

.column(date, type) ⇒ Object

七曜表の一日分

Parameters:

Returns:

  • (Object) —

    ] 処理結果



141
142
143
144
145
146
147
148
149
 
# File 'lib/when_exe/mini_application.rb', line 141

def column(date, type)
  case type
  when When::YEAR  ; date.strftime("%Y")
  when When::MONTH ; date.strftime("%B %Y")
  when When::WEEK  ; nil
  when When::DAY   ; date[0]
  else             ; '-'
  end
end

.config(path = File.expand_path($0) + '.config') ⇒ Object

設定ファイルを読み込む



32
33
34
35
36
37
38
39
40
41
42
43
44
45
 
# File 'lib/when_exe/mini_application.rb', line 32

def config(path=File.expand_path($0) + '.config')
  config = {}
  open(path, 'r') do |file|
    while (line=file.gets)
      next if line =~ /\A\s*#/
      key, *value = line.chomp.split(':')
      value = value[0] if value.size <= 1
      config[key] = value
    end
  end
  config
rescue
  {}
end

.const_missing(constant) ⇒ Object

When 直下に定数として定義する時法・暦法など(暗黙的追加)



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

def const_missing(constant)
  sgn, *args = TM::PeriodDuration._to_array(constant.to_s)
  return const_set(constant, TM::PeriodDuration.new(*args)) if sgn
  iri = Parts::Resource._abbreviation_to_iri(constant)
  return _const_missing(constant) unless iri
  resource = Parts::Resource._instance(iri)
  return const_get(constant) if const_defined?(constant)
  Parts::Resource.synchronize do
    Parts::Resource::ConstList << constant
    const_set(constant, resource)
  end
end

.date_or_era(*args) ⇒ When::TM::TemporalPosition or When::TM::CalendarEra

When::TM::TemporalPosition または When::TM::CalendarEraの検索

Parameters:

  • args (Array<Object>) —

    when? または era にそのまま渡される

Returns:



789
790
791
792
793
794
795
 
# File 'lib/when_exe.rb', line 789

def date_or_era(*args)
  begin
    when?(*args)
  rescue
    era(*args).first
  end
end

.Duration(period, options = {}) ⇒ When::TM::Duration or Array<them>

When::TM::Duration の生成

Parameters:

  • period (String) —

    When.exe Standard Representation として解釈して生成する

  • period (Numeric) —

    When::TM::IntervalLength::SYSTEM 単位の値として解釈して生成する

  • period (Array) —

    要素を個別に解釈して生成したオブジェクトのArrayを返す

  • period (When::TM::Duration) —

    処理を行わず、そのまま返す

  • options (Hash) (defaults to: {}) —

    現時点では未使用

Returns:



695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
 
# File 'lib/when_exe.rb', line 695

def Duration(period, options={})
  case period
  when Array
    period.map {|e| Duration(e, options)}

  when TM::Duration
    period

  when 0
    TM::IntervalLength.new(0, 'day')

  when Numeric
    [TM::Duration::YEAR, TM::Duration::MONTH,  TM::Duration::WEEK, TM::Duration::DAY,
     TM::Duration::HOUR, TM::Duration::MINUTE, TM::Duration::SECOND].each do |unit|
      div, mod = period.divmod(unit)
      return TM::IntervalLength.new(div, TM::Duration::Unit.invert[unit]) if mod == 0
    end
    TM::IntervalLength.new(period, 'system')

  when String
    # IntervalLength
    args = TM::IntervalLength._to_array(period)
    return TM::IntervalLength.new(*args) if args

    # PeriodDuration
    sign, *args = TM::PeriodDuration._to_array(period)
    raise TypeError, "Argument 'period' is not a Duration" unless (sign)
    args << options
    duration = TM::PeriodDuration.new(*args)
    return (sign >= 0) ? duration : -duration

  else
    nil
  end
end

.era(key, epoch = nil, reverse = nil, options = {}) ⇒ Array<When::TM::CalendarEra>

Note:

ヒット数が不足している場合は、setup で指定した順序で When::TM::CalendarEra オブジェクトを生成しつつ読み込んで検索する。

When::TM::CalendarEra の検索

Parameters:

  • key (String, Regexp) —

    検索する暦年代または、暦年代にマッチする正規表現

  • epoch (Integer) (defaults to: nil) —

    年数を昇順にカウントする方式での暦元(0年)の通年(デフォルトは nil - 指定なし)

  • reverse (Integer) (defaults to: nil) —

    年数を降順にカウントする方式での暦元(0年)の通年(デフォルトは nil - 指定なし)

  • options (Hash) (defaults to: {}) —

    以下の通り

Options Hash (options):

  • :area (String) —

    暦年代の使用地域の指定(デフォルトは nil - 指定なし)

  • :period (String) —

    暦年代の使用時代の指定(デフォルトは nil - 指定なし)

  • :count (Integer) —

    何件ヒットするまで検索するかを指定(デフォルトは 1件)

  • the_others (String) —

    例えば When::TM::CalendarEra オブジェクトの epoch_of_use に ‘name’ などの 指定がある場合、:name に指定しておけば、検索での絞り込みに使用できる。

Returns:



779
780
781
 
# File 'lib/when_exe.rb', line 779

def era(*args)
  TM::CalendarEra._instance(*args)
end

.free_conv(*args, &block) ⇒ Array<Hash>, Array<Array<Numeric>>

Note:

暦法のIRI, When.exe Standard Expression, 最良近似分数列の分母分子などを文字列で指定

Note:

mini_application

日付の自由変換

Parameters:

Returns:



116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
 
# File 'lib/when_exe/mini_application.rb', line 116

def free_conv(*args, &block)
  calendars, dates, numbers, methods, output, options = _parse_command(args)

  if numbers.size >= 2 && calendars.size == 0
    result = []
    When::Coordinates::Residue.new(numbers[0], numbers[1]).each { |v| result << v }
    return result
  end

  block ||= 
    if methods.size == 0
      lambda {|date| date.send(*output)}
    else
      lambda {|date, type| column(date, type)}
    end
  _free_conv(calendars, dates, methods, output, options, &block)
end

.Index(terms = nil, name = 'Month', options) ⇒ When::Coordinates::Index

When::Coordinates::Index の生成

Parameters:

  • terms (String) (defaults to: nil) —

    trunk の用語空間名

  • name (String) (defaults to: 'Month') —

    trunk の要素配列名

  • options (Hash)

Options Hash (options):

  • :trunk (Array) —

    幹の要素(省略時は使用しない)

  • :branch (Hash) —

    枝の要素(省略時は使用しない)

  • :unit (Integer) —

    要素の数(省略時は不定)

  • :base (Integer) —

    要素の最初の添え字(0 or 1(デフォルト))

  • :shift (Integer) —

    幹の要素のローテート数(省略時はローテートしない)

Returns:



1011
1012
1013
 
# File 'lib/when_exe.rb', line 1011

def Index(*args)
  Coordinates::Index.new(*args)
end

.Location(location) ⇒ When::Coordinates::Spatial .Location(longitude, latitide, altitide = 0, datum = 'Earth') ⇒ When::Coordinates::Spatial

Note:

longitudeが経度を意味する文字列, latitude が緯度を意味する文字列の場合、 引数の順番によらず、それぞれ経度および緯度と解釈する

When::Coordinates::Spatial の生成/参照

Overloads:

Returns:

Raises:

  • (ArgumentError) 


843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
 
# File 'lib/when_exe.rb', line 843

def Location(*args)
  case args[0]
  when Coordinates::Spatial ; return args[0]
  when Parts::Timezone      ; return args[0].location
  when String               ; return Parts::Resource._instance(args[0], '_l:') if args.size == 1
  when Numeric              ;
  else                      ; raise TypeError, "Invalid Type: #{args[0].class}"
  end
  rest = []
  longitude = latitude = nil
  args.each do |arg|
    case arg
    when /\A#{Coordinates::MATCH['EW']}\s*[.@\d]/, /[.@\d]\s*#{Coordinates::MATCH['EW']}\z/; longitude = arg
    when /\A#{Coordinates::MATCH['NS']}\s*[.@\d]/, /[.@\d]\s*#{Coordinates::MATCH['NS']}\z/; latitude  = arg
    else ; rest << arg
    end
  end
  longitude ||= rest.shift
  latitude  ||= rest.shift
  raise ArgumentError, "too few arguments" unless longitude && latitude
  altitude, datum = rest
  iri = "_l:long=#{longitude}&lat=#{latitude}"
  iri += "&alt=#{altitude}" if altitude
  iri += "&datum=#{datum}"  if datum
  Parts::Resource._instance(iri)
end

.m17n(source, namespace = nil, locale = nil, options = {}) ⇒ When::BasicTypes::M17n or Array<them>

When::BasicTypes::M17n の生成/参照

Parameters:

  • source (When::BasicTypes::M17n) —

    処理を行わず、そのままsourceを返す

  • source (String) —

    locale と 文字列の対応

  • source (Array) —

    要素を個別に解釈して生成したオブジェクトのArrayを返す

  • namespace (Hash) (defaults to: nil) —

    prefix の指定

  • locale (Array) (defaults to: nil) —

    locale の定義順序の指定

  • options (Hash) (defaults to: {}) —

    (see When::BasicTypes::M17n.new)

Returns:



948
949
950
951
952
953
954
955
956
957
958
959
 
# File 'lib/when_exe.rb', line 948

def m17n(source, namespace=nil, locale=nil, options={})
  case source
  when Array            ; BasicTypes::M17n.new(source, namespace, locale, options)
  when BasicTypes::M17n ; source
  when String
    source = EncodingConversion.to_internal_encoding(source)
    return self[$1] if source =~ /\A\s*\[((\.{1,2}|::)+[^\]]+)\]/ && self.kind_of?(When::Parts::Resource)
    return Parts::Resource[$1] if source =~ /\A\s*\[::([^\]]+)\]/
    BasicTypes::M17n.new(source, namespace, locale, options)
  else ; raise TypeError, "Invalid Type: #{source.class}"
  end
end

.M17n(source) ⇒ When::BasicTypes::M17n

When::BasicTypes::M17n の生成/参照

Parameters:

  • source (String) —

    多言語対応文字列のIRI

Returns:



933
934
935
 
# File 'lib/when_exe.rb', line 933

def M17n(source)
  Parts::Resource._instance(source, '_m:')
end

.MonthName(name) ⇒ When::BasicTypes::M17n

月名

Parameters:

  • name (Numeric) —

    指定の月番号の月名を返します

  • name (String) —

    最初の3文字から決定した月名を返します。 一致する月名がない場合、名前の一致するその他のM17nを探して返します。 (name が M17n なら name 自身をそのまま返します)

Returns:



923
924
925
 
# File 'lib/when_exe.rb', line 923

def MonthName(name)
  When::BasicTypes::M17n.month_name(name)
end

.now(options = {}) ⇒ When::TM::DateAndTime

Note:

メソッド実行時の「現在日時」である。@indeterminated_position は設定しないので自動的に日時が進むことはない

現在日時に対応する When::TM::TemporalPosition の生成 (When::TM::DateAndTime of now)

Parameters:

  • options (Hash) (defaults to: {}) —

    暦法や時法などの指定

Returns:

See Also:



667
668
669
 
# File 'lib/when_exe.rb', line 667

def now(options={})
  When.at(Time.now, options)
end

.Pair(trunk, branch = nil) ⇒ When::Coordinates::Pair

When::Coordinates::Pair の生成

Parameters:

Returns:

See Also:



1023
1024
1025
 
# File 'lib/when_exe.rb', line 1023

def Pair(trunk, branch=nil)
  Coordinates::Pair._force_pair(trunk, branch)
end

.Residue(day) ⇒ When::Coordinates::Residue Also known as: day_of_week

曜日(剰余類)

Parameters:

  • day (Numeric) —

    月曜を 0 とする七曜(剰余類)を返します

  • day (String) —

    最初の3文字から決定した七曜(剰余類)を返します。 一致する七曜(剰余類)がない場合、名前の一致するその他の剰余類を探して返します。

Returns:



908
909
910
 
# File 'lib/when_exe.rb', line 908

def Residue(day)
  When::Coordinates::Residue.to_residue(day)
end

.Resource(iri, namespace = nil) ⇒ When::Parts::Resourc Also known as: IRI

When::Parts::Resource の生成/参照

Parameters:

  • iri (String) —

    IRI を表す文字列

  • namespace (String) (defaults to: nil) —

    デフォルトの namespace

Returns:

  • (When::Parts::Resourc) —

    iri (または namespace:iri) に対応する When::Parts::Resource オブジェクト



992
993
994
 
# File 'lib/when_exe.rb', line 992

def Resource(iri, namespace=nil)
  Parts::Resource._instance(iri, namespace)
end

.server(port) ⇒ void

Note:

mini_application

This method returns an undefined value.

マイクロ・サーバーを起動する

Parameters:

  • port (#to_i) —

    待ち受けるポート番号



56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
 
# File 'lib/when_exe/mini_application.rb', line 56

def server(port)
  config = When.config
  TCPServer.open(port.to_i) do |socket|
    puts Time.now._log_('%FT%X.%L') + ': Start'
    loop do
      Thread.start(socket.accept) do |client|
        query = client.gets.chomp.force_encoding("UTF-8")
        start = Time.now
        puts start._log_('%FT%X.%L') + ': Query - ' + When::Locale.translate(query, config['!'])
        begin
          result = free_conv(*query.split(/\s+/))
          result = When::Locale.translate(result, config['!'])
          client.puts JSON.generate(Array(_to_string(result))).to_s
          stop = Time.now
          puts stop._log_('%FT%X.%L') + ": Respond (%7.0f ms)" % (1000 * (stop.to_f - start.to_f))
        rescue => err
          puts Time.now._log_('%FT%X.%L') + ': error - ' + err.to_s
          client.puts JSON.generate({:error=>query}).to_s
        end
        client.close
      end
    end
  end
rescue Exception => e
  puts Time.now._log_('%FT%X.%L') + ': Exception - ' + e.to_s
ensure
  puts Time.now._log_('%FT%X.%L') + ': Done.'
end

.strptime(date_time, format, options = {}) ⇒ When::TM::TemporalPosition

書式文字列に従った When::TM::TemporalPosition の生成

see strptime

Parameters:

  • date_time (String) —

    日時を表す文字列

  • format (String) —

    その書式

  • options (Hash) (defaults to: {}) —

    暦法や時法などの指定

Options Hash (options):

  • :locale (String) —

    言語指定

  • :その他 (Object) —

    When::TM::TemporalPosition._instance に渡す

Returns:

Raises:

  • (ArgumentError) —

    options[ :invalid ] が :raise で、日時が存在しない場合

See Also:



616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
 
# File 'lib/when_exe.rb', line 616

def strptime(date_time, format, options={})
  h = When::Locale._to_date_time_hash(date_time, format, options[:locale])
  frame = options[:frame] ? When.Calendar(options[:frame]) : When::Gregorian
  abbr_y, abbr_m, abbr_d, = options[:abbr].kind_of?(When::TimeValue) ?
    (frame ^ options[:abbr]).cal_date : options[:abbr]
  args =  [h[:year] || abbr_y || ::Date.today.year]
  args << (h[:mon]  || abbr_m || 1) if h[:hour] ||  h[:mon]
  args << (h[:mday] || abbr_d || 1) if h[:hour] || (h[:mon] && h[:mday])
  args <<  h[:hour] if h[:hour]
  args <<  h[:min]  if h[:hour] && h[:min]
  args <<  h[:sec]  if h[:hour] && h[:min] && h[:sec]
  args << options.dup
  args[-1].delete(:locale)
  args[-1].delete(:abbr)
  args[-1].update({:parse=>{:residue=>{frame.indices.length=>When.Residue((h[:wday]-1)%7)}}}) if h[:wday]
  args[-1].update({:clock=>When::TM::Clock.to_hms(h[:offset])}) if h[:offset]
  TM::TemporalPosition._temporal_position(*args)
end

.TemporalPosition(*args, options = {}) ⇒ When::TM::TemporalPosition Also known as: tm_pos

When::TM::TemporalPosition の生成

Parameters:

  • args (String or [String, Integer], Numeric, ...) —
    String

    年号

    Array<String, Integer>

    年号と 0 年の通年

    Numeric

    年月日時分秒(途中で打ち切り可)

  • options (Hash) (defaults to: {}) —

    暦法や時法などの指定

Options Hash (options):

  • :invalid (Symbol) —
    :raise 日時が存在しない場合例外発生
    :check 日時が存在しない場合 nil を返す
    その他/nil 日時が存在することを確認しない(デフォルト)

See Also:

Returns:

Raises:

  • (ArgumentError) —

    options[ :invalid ] が :raise で、日時が存在しない場合



594
595
596
 
# File 'lib/when_exe.rb', line 594

def TemporalPosition(*args)
  TM::TemporalPosition._temporal_position(*args)
end

.today(options = {}) ⇒ When::TM::CalDate

Note:

メソッド実行時の「本日」である。@indeterminated_position は設定しないので自動的に日時が進むことはない

Note:

options で時間帯を指定しても「本日」の決定に使用するのみで、戻り値には反映されない

本日に対応する When::TM::CalDate の生成 (When::TM::CalDate of today)

Parameters:

  • options (Hash) (defaults to: {}) —

    暦法や時法などの指定

Returns:

See Also:



681
682
683
 
# File 'lib/when_exe.rb', line 681

def today(options={})
  now(options.merge({:precision=>DAY}))
end

.when?(specification, options = {}) ⇒ When::TM::TemporalPosition, ...

Generation of Temporal Objetct, duration or When::Parts::GeometricComplex

Parameters:

Returns:



559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
 
# File 'lib/when_exe.rb', line 559

def when?(specification, options={})

  # フォーマットごとの処理
  case specification
  when TM::TemporalPosition, Parts::GeometricComplex ; specification
  when TM::Position ; specification.any_other
  when Array        ; begin options = TM::TemporalPosition._options(options) ; specification.map {|e| when?(e, options)} end
  when /\Atoday((\^|%5E){1,2}(.+))?\z/i ; today($3 ? {:frame=>$3}.update(options) : options)
  when /\Anow((\^|%5E){1,2}(.+))?\z/i   ; now(  $3 ? {:frame=>$3}.update(options) : options)
  when /(JDN|MJD|SDN|CEP|DTB)(\z|\^|%5E)/i  ; TM::JulianDate.parse(specification, options)
  when /[\n\r]+/    ; when?(specification.split(/[\n\r]+/), options)
  when String       ; TM::TemporalPosition._instance(EncodingConversion.to_internal_encoding(specification), options)
  when Numeric      ; TM::JulianDate.new(+specification, TM::TemporalPosition._options(options))
  else              ; Calendar(options[:frame] || 'Gregorian').jul_trans(specification, options)
  end
end

.where?(name) ⇒ When::Coordinates::Spatial or When::Coordinates::Spatial::Range

地名を空間座標化する

Parameters:

  • name (String) —

    地名または座標

Returns:



877
878
879
 
# File 'lib/when_exe.rb', line 877

def where?(name)
  When::Coordinates::Spatial::Range[name]
end

.Wikipedia(title, options = {}) ⇒ When::BasicTypes::M17n

Note:

生成した多言語対応文字列の what が nil でない場合、 その項目の位置情報を表わす When::Coordinates::Spatial を指す

Wikipedia を参照して When::BasicTypes::M17n を生成する

Parameters:

  • title (String) —

    Wikipedia の項目名

  • options (Hash) (defaults to: {}) —

    以下の通り

Options Hash (options):

  • :locale (String) —

    Wikipedia の言語(デフォルト ‘en’ - 英語)

  • :interval (Numeric, nil) —

    Wikipedia サイトへのアクセス制御(デフォルト When::Locale.wikipedia_interval)

  • :その他 (Object) —

    キャッシュファイルへの追加書き出し要素

Returns:



974
975
976
977
978
979
980
981
982
983
 
# File 'lib/when_exe.rb', line 974

def Wikipedia(title, options={})
  locale = options.delete(:locale) || 'en'
  title  = EncodingConversion.to_internal_encoding(title)
  entry, query = title.split('?', 2)
  url  = "https://#{locale}.wikipedia.org/wiki/#{CGI.escape(entry).gsub(' ', '_')}"
  Locale.send(:wikipedia_object, url, options) unless options.empty?
  url += '?' + query if query
  object = Parts::Resource._instance(url)
  object.to_m17n
end