Share via


TimeZone Element (Regional Settings)

Applies to: SharePoint Foundation 2010

Defines a time zone for regional settings in TIMEZONE.XML (%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\CONFIG). or specifies a time zone in RGNLSTNG.XML (%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\1033\XML).

<TimeZone
  Hidden = "TRUE" | "FALSE"
  HTMLEncode = "TRUE" | "FALSE"
  ID = "Integer"
    Name = "Text">
  <StandardTime>
  ...
    </StandardTime>
  <DaylightTime>
  ...
    </DaylightTime>
  <History>
  ...
    </History>
</TimeZone>

Attributes

Attribute

Description

Hidden

Optional Boolean.

HTMLEncode

Optional Boolean. TRUE to convert embedded characters so that they are displayed as text in the browser. In other words, characters that could be confused with HTML tags are converted to entities.

ID

Required Integer. Specifies the ID for the time zone.

Name

Required Text. Specifies the name of the time zone.

Child Elements

Bias, DaylightTime, History, StandardTime

Parent Elements

TimeZones

Occurrences

Minimum: 0

Maximum: Unbounded

Remarks

Outside the context of RGNLSTNG.XML or TIMEZONE.XML, use an empty TimeZone element to return the current time zone.

Example

The following example from the file TIMEZONE.XML defines a time zone.

<TimeZone ID="13" Name="(GMT-08:00) Pacific Time (US and Canada); 
      Tijuana" Hidden="FALSE">
   <Bias>480</Bias>
   <StandardTime>
      <Bias>0</Bias>
      <Date>
         <Month>10</Month>
         <Day>5</Day>
         <Hour>2</Hour>
      </Date>
   </StandardTime>
   <DaylightTime>
      <Bias>-60</Bias>
      <Date>
         <Month>4</Month>
         <Day>1</Day>
         <Hour>2</Hour>
      </Date>
   </DaylightTime>
</TimeZone>