U:RDoc::NormalClass[iI"
Timezone:ETI"TZInfo::Timezone;TI"Object;To:RDoc::Markup::Document:@parts[o;;[o:RDoc::Markup::Paragraph;[I"PThe {Timezone} class represents a time zone. It provides a factory method, ;TI"A{get}, to retrieve {Timezone} instances by their identifier.;To:RDoc::Markup::BlankLineo;	;[I"QThe {Timezone#to_local} method can be used to convert `Time` and `DateTime` ;TI";instances to the local time for the zone. For example:;T@o:RDoc::Markup::Verbatim;[I"3tz = TZInfo::Timezone.get('America/New_York')
;TI";local_time = tz.to_local(Time.utc(2005,8,29,15,35,0))
;TI"Clocal_datetime = tz.to_local(DateTime.new(2005,8,29,15,35,0))
;T:@format0o;	;[I"KLocal `Time` and `DateTime` instances returned by `Timezone` have the ;TI"correct local offset.;T@o;	;[	I"PThe {Timezone#local_to_utc} method can by used to convert local `Time` and ;TI"Q`DateTime` instances to UTC. {Timezone#local_to_utc} ignores the UTC offset ;TI"Nof the supplied value and treats if it is a local time for the zone. For ;TI"
example:;T@o;;[I"3tz = TZInfo::Timezone.get('America/New_York')
;TI"=utc_time = tz.local_to_utc(Time.new(2005,8,29,11,35,0))
;TI"Eutc_datetime = tz.local_to_utc(DateTime.new(2005,8,29,11,35,0))
;T;0o;	;[
I"QEach time zone is treated as sequence of periods of time ({TimezonePeriod}) ;TI"Bthat observe the same offset ({TimezoneOffset}). Transitions ;TI"N({TimezoneTransition}) denote the end of one period and the start of the ;TI"Pnext. The {Timezone} class has methods that allow the periods, offsets and ;TI"3transitions of a time zone to be interrogated.;T@o;	;[I"IAll methods that take `Time` objects as parameters can be used with ;TI"Parbitrary `Time`-like objects that respond to both `to_i` and `subsec` and ;TI"optionally `utc_offset`.;T@o;	;[I"OThe {Timezone} class is thread-safe. It is safe to use class and instance ;TI"Kmethods of {Timezone} in concurrently executing threads. Instances of ;TI"7{Timezone} can be shared across thread boundaries.;T@o;	;[
I"RThe IANA Time Zone Database maintainers recommend that time zone identifiers ;TI"6are not made visible to end-users (see [Names of ;TI"Ktimezones](https://data.iana.org/time-zones/theory.html#naming)). The ;TI"K{Country} class can be used to obtain lists of time zones by country, ;TI"Dincluding user-friendly descriptions and approximate locations.;T@o;	;[I"O@abstract The {get} method returns an instance of either {DataTimezone} or;To;;[I"J{LinkedTimezone}. The {get_proxy} method and other methods returning
;TI"Ccollections of time zones return instances of {TimezoneProxy}.;T;0:
@fileI"lib/tzinfo/timezone.rb;T:0@omit_headings_from_table_of_contents_below0;
0;0[[[[I"Comparable;To;;[;
@J;0I"lib/tzinfo/timezone.rb;T[[I"
class;T[[:public[[I"
_load;T@R[I"all;T@R[I"!all_country_zone_identifiers;T@R[I"all_country_zones;T@R[I"all_data_zone_identifiers;T@R[I"all_data_zones;T@R[I"all_identifiers;T@R[I" all_linked_zone_identifiers;T@R[I"all_linked_zones;T@R[I"default_dst;T@R[I"default_dst=;T@R[I"get;T@R[I"get_proxy;T@R[:protected[[:private[[I"data_source;T@R[I"get_proxies;T@R[I"
instance;T[[;[([I"<=>;T@R[I"=~;T@R[I"
_dump;T@R[I"	abbr;T@R[I"abbreviation;T@R[I"base_utc_offset;T@R[I"canonical_identifier;T@R[I"canonical_zone;T@R[I"current_period;T@R[I"current_period_and_time;T@R[I"current_time_and_period;T@R[I"	dst?;T@R[I"	eql?;T@R[I"friendly_identifier;T@R[I"	hash;T@R[I"identifier;T@R[I"inspect;T@R[I"local_datetime;T@R[I"local_time;T@R[I"local_timestamp;T@R[I"local_to_utc;T@R[I"	name;T@R[I"now;T@R[I"observed_utc_offset;T@R[I"offsets_up_to;T@R[I"period_for;T@R[I"period_for_local;T@R[I"period_for_utc;T@R[I"periods_for_local;T@R[I"
strftime;T@R[I"
to_local;T@R[I"	to_s;T@R[I"transitions_up_to;T@R[I"utc_offset;T@R[I"utc_to_local;T@R[;[[;[[I"raise_unknown_timezone;T@R[[U:RDoc::Context::Section[i0o;;[;
0;0[@JI"TZInfo;TcRDoc::NormalModule