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” など)



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
182
183
184
185
186
# File 'lib/when_exe/parts/timezone.rb', line 148

def initialize(identifier)
  @identifier = identifier
  id, query   = identifier.split('?', 2)
  @timezone   = TZInfo::Timezone.get(id.sub(/\(.+?\)\z/,''))
  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) に委譲する


237
238
239
240
241
242
243
244
# File 'lib/when_exe/parts/timezone.rb', line 237

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

#identifierString (readonly) Also known as: label, inspect

ユニーク識別名

Returns:



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

def identifier
  @identifier
end

#indicesArray<When::Coordinates::Index> (readonly)

時分秒のインデクス



142
143
144
# File 'lib/when_exe/parts/timezone.rb', line 142

def indices
  @indices
end

#timezoneTZInfo::Timezone (readonly)

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

Returns:

  • (TZInfo::Timezone)


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

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

._getObject



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

alias :_get :[]

.tz_infoHash

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
# 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|
    @tz_info[id] = hash[hash.keys[0]]
    unless hash.keys.size == 1
      hash.each_pair do |c, z|
        @tz_info["#{id}(#{c})"] = z
      end
    end
  end
  @tz_info
end

Instance Method Details

#_daylight(time) ⇒ Object



189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
# File 'lib/when_exe/parts/timezone.rb', line 189

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_validateObject



213
214
215
# File 'lib/when_exe/parts/timezone.rb', line 213

def _need_validate
  true
end

#latitudeRational

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

Returns:

  • (Rational)


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

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

#locationWhen::Coordinates::Spatial

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



126
127
128
129
130
131
132
133
134
135
136
137
138
# File 'lib/when_exe/parts/timezone.rb', line 126

def location
  return @location if @location
  city_tz = @timezone
  unless self.class.tz_info[label]
    while city_tz.kind_of?(TZInfo::LinkedTimezone)
      city_tz = TZInfo::Timezone.get(city_tz.send(:info).link_to_identifier)
    end
  end
  tzinfo = self.class.tz_info[city_tz.identifier]
  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

#longitudeRational

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

Returns:

  • (Rational)


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

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