Class: When::Parts::Timezone

Inherits:
Object
  • Object
show all
Extended by:
Resource::Pool
Includes:
Base
Defined in:
lib/when_exe/parts/timezone.rb,
lib/when_exe/inspect.rb

Overview

TZInfo::Timezone クラスを本ライブラリから使用するためのラッパークラス

Defined Under Namespace

Modules: Base

Instance Attribute Summary collapse

Attributes included from Base

#daylight, #standard, #tz_difference

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Resource::Pool

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

Methods included from Resource::Synchronize

#synchronize

Methods included from Base

#^

Constructor Details

#initialize(identifier) ⇒ Timezone

オブジェクト生成

Parameters:

  • identifier (String) —

    識別名 ( “America/New_York” など)



143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
 
# File 'lib/when_exe/parts/timezone.rb', line 143

def initialize(identifier)
  @identifier = identifier
  id, query   = identifier.split('?', 2)
  @timezone   = TZInfo::Timezone.get(id)
  unless TZInfo::TimeOrDateTime.method_defined?(:_to_datetime)
    if TZInfo::RubyCoreSupport.respond_to?(:datetime_new)
      TZInfo::TimeOrDateTime.class_eval %Q{
        alias :_to_datetime :to_datetime
        ::Rational
        def to_datetime
          unless @datetime
            u = usec
            s = u == 0 ? sec : Rational(sec * 1000000 + u, 1000000)
            @datetime = TZInfo::RubyCoreSupport.datetime_new(year, mon, mday, hour, min, s, 0, Date::GREGORIAN)
          end
          @datetime
        end
      }
    else
      TZInfo::TimeOrDateTime.class_eval %Q{
        alias :_to_datetime :to_datetime
        def to_datetime
          @datetime ||= DateTime.new(year, mon, mday, hour, min, sec, 0, Date::GREGORIAN)
        end
      }
    end
  end
  dst, std  = _offsets(Time.now.to_i)
  options   = query ? Hash[*(query.split('&').map {|item| item.split('=',2)}.flatten)] : {}
  @standard = When::TM::Clock.new(options.merge({:zone=>std, :tz_prop=>self}))
  if std == dst
    @daylight      = @standard
    @tz_difference = 0
  else
    @daylight      = When::TM::Clock.new(options.merge({:zone=>dst, :tz_prop=>self}))
    @tz_difference = @standard.universal_time - @daylight.universal_time
  end
  @indices = When::Coordinates::DefaultTimeIndices
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(name, *args, &block) ⇒ Object (private)

その他のメソッド

When::Parts::GeometricComplex で定義されていないメソッドは
処理を first (type: When::TM::(Temporal)Position) に委譲する



232
233
234
235
236
237
238
239
 
# File 'lib/when_exe/parts/timezone.rb', line 232

def method_missing(name, *args, &block)
  self.class.module_eval %Q{
    def #{name}(*args, &block)
      timezone.send("#{name}", *args, &block)
    end
  } unless When::Parts::MethodCash.escape(name)
  timezone.send(name, *args, &block)
end

Instance Attribute Details

#identifier ⇒ String (readonly) Also known as: label, inspect

ユニーク識別名

Returns:



109
110
111
 
# File 'lib/when_exe/parts/timezone.rb', line 109

def identifier
  @identifier
end

#indices ⇒ Array<When::Coordinates::Index> (readonly)

時分秒のインデクス

Returns:



137
138
139
 
# File 'lib/when_exe/parts/timezone.rb', line 137

def indices
  @indices
end

#timezone ⇒ TZInfo::Timezone (readonly)

ラップしている TZInfo::Timezone インスタンス

Returns:

  • (TZInfo::Timezone) 


105
106
107
 
# File 'lib/when_exe/parts/timezone.rb', line 105

def timezone
  @timezone
end

Class Method Details

.[](label) ⇒ When::Parts::Timezone Also known as: get

オブジェクト参照

Parameters:

  • label (String) —

    識別名 ( “America/New_York” など)

Returns:



61
62
63
64
65
66
67
68
 
# File 'lib/when_exe/parts/timezone.rb', line 61

def [](label)
  ref = _get(label)
  return ref if ref
  return nil unless label =~ /\A[A-Z]/i
  self[label] = self.new(label)
rescue NameError
  raise NameError, 'Prease install TZInfo - gem install tzinfo'
end

._get ⇒ Object 



53
 
# File 'lib/when_exe/parts/timezone.rb', line 53

alias :_get :[]

.tz_info ⇒ Hash

TZInfo でサポートしている Timezone の連想配列

Returns:

  • (Hash) —

    { String => TZInfo::CountryTimezone }

    String - 時間帯ID
    TZInfo::CountryTimezone - 時間帯オブジェクト(proxy for autoload) 


77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
 
# File 'lib/when_exe/parts/timezone.rb', line 77

def tz_info
  return @tz_info if @tz_info
  zones = {}
  TZInfo::Country.all.each do |c|
    c.zone_info.each do |z|
      zones[z.identifier]       ||= {}
      zones[z.identifier][c.code] = z
    end
  end

  @tz_info = {}
  zones.each_pair do |id, hash|
    if hash.keys.size == 1
      @tz_info[id] = hash[hash.keys[0]]
    else
      hash.each_pair do |c, z|
        @tz_info["#{id}(#{c})"] = z
      end
    end
  end
  @tz_info
end

Instance Method Details

#_daylight(time) ⇒ Object 



184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
 
# File 'lib/when_exe/parts/timezone.rb', line 184

def _daylight(time)
  frame, cal_date, clk_time = time
  clocks  = {}
  options = {}
  %w(border location).each do |attr|
    value = @standard.instance_variable_get("@#{attr}")
    next unless value
    value = value.dup unless value.kind_of?(When::Parts::Resource) && value.registered?
    options[attr] = value
  end
  if clk_time
    time    = frame.to_universal_time(cal_date, clk_time, @standard)
    offsets = _offsets((time/When::TM::Duration::SECOND).floor)
    offsets.each do |offset|
      clocks[offset] ||= When::TM::Clock.new(options.merge({:zone=>offset, :tz_prop=>self}))
      return clocks[offsets[0]] if @timezone.period_for_utc(
        (frame.to_universal_time(cal_date, clk_time, clocks[offset])/When::TM::Duration::SECOND).floor).dst?
    end
  end
  offset = @timezone.period_for_utc((time/When::TM::Duration::SECOND).floor).utc_total_offset
  clocks[offset] || When::TM::Clock.new(options.merge({:zone=>offset, :tz_prop=>self}))
end

#_need_validate ⇒ Object 



208
209
210
 
# File 'lib/when_exe/parts/timezone.rb', line 208

def _need_validate
  true
end

#latitude ⇒ Rational

時間帯を代表する都市の緯度 / 度

Returns:

  • (Rational) 


121
122
123
 
# File 'lib/when_exe/parts/timezone.rb', line 121

def latitude
  self.class.tz_info[label].latitude
end

#location ⇒ When::Coordinates::Spatial

時間帯を代表する都市の空間位置

Returns:



127
128
129
130
131
132
133
 
# File 'lib/when_exe/parts/timezone.rb', line 127

def location
  return @location if @location
  tzinfo = self.class.tz_info[label]
  longitude = When::Coordinates.to_dms(tzinfo.longitude, 'EW')
  latitude  = When::Coordinates.to_dms(tzinfo.latitude,  'NS')
  @location = When.Resource("_l:long=#{longitude}&lat=#{latitude}&label=#{label}")
end

#longitude ⇒ Rational

時間帯を代表する都市の経度 / 度

Returns:

  • (Rational) 


115
116
117
 
# File 'lib/when_exe/parts/timezone.rb', line 115

def longitude
  self.class.tz_info[label].longitude
end