U:RDoc::AnyMethod[iI"canonical_zone:ETI"$TZInfo::Timezone#canonical_zone;TF:publico:RDoc::Markup::Document:@parts[o:RDoc::Markup::Paragraph;	[I"CReturns the canonical {Timezone} instance for this {Timezone}.;To:RDoc::Markup::BlankLineo;
;	[	I"MThe IANA Time Zone database contains two types of definition: Zones and ;TI"LLinks. Zones are defined by rules that set out when transitions occur. ;TI"LLinks are just references to fully defined Zone, creating an alias for ;TI"that Zone.;T@o;
;	[	I"PLinks are commonly used where a time zone has been renamed in a release of ;TI"Mthe Time Zone database. For example, the US/Eastern Zone was renamed as ;TI"LAmerica/New_York. A US/Eastern Link was added in its place, linking to ;TI"2(and creating an alias for) America/New_York.;T@o;
;	[I"OLinks are also used for time zones that are currently identical to a full ;TI"PZone, but that are administered separately. For example, Europe/Vatican is ;TI"+a Link to (and alias for) Europe/Rome.;T@o;
;	[I"OFor a full Zone (implemented by {DataTimezone}), {canonical_zone} returns ;TI"
self.;T@o;
;	[I"NFor a Link (implemented by {LinkedTimezone}), {canonical_zone} returns a ;TI"J{Timezone} instance representing the full Zone that the link targets.;T@o;
;	[	I"OTZInfo can be used with different data sources (see the documentation for ;TI"L{TZInfo::DataSource}). Some DataSource implementations may not support ;TI"Odistinguishing between full Zones and Links and will treat all time zones ;TI"Mas full Zones. In this case, {canonical_zone} will always return `self`.;T@o;
;	[I"8There are two built-in DataSource implementations. ;TI"N{DataSources::RubyDataSource} (which will be used if the tzinfo-data gem ;TI"Jis available) supports Link zones. {DataSources::ZoneinfoDataSource} ;TI"Oreturns Link zones as if they were full Zones. If the {canonical_zone} or ;TI"N{canonical_identifier} methods are needed, the tzinfo-data gem should be ;TI"installed.;T@o;
;	[I"OThe {TZInfo::DataSource.get} method can be used to check which DataSource ;TI""implementation is being used.;T@o;
;	[I"N@return [Timezone] the canonical {Timezone} instance for this {Timezone}.;T:
@fileI"lib/tzinfo/timezone.rb;T:0@omit_headings_from_table_of_contents_below000[I"();T@=FI"
Timezone;TcRDoc::NormalClass00