3.1.4.30.3.1 CultureCommandParameter

Namespace: http://schemas.microsoft.com/office/Excel/Server/WebServices/ExcelServerInternalService/

The CultureCommandParameter is used to specify UI culture, data culture and host data language related information when creating a new session.

 <xs:complexType name="CultureCommandParameter">
   <xs:sequence>
     <xs:element minOccurs="0" maxOccurs="1" name="UICultureName" type="xs:string"/>
     <xs:element minOccurs="0" maxOccurs="1" name="DataCultureName" type="xs:string"/>
     <xs:element minOccurs="0" maxOccurs="1" name="SharePointDataCultureName" type="xs:string"/>
     <xs:element minOccurs="0" maxOccurs="1" name="TimeZoneSerialization" type="xs:string"/>
   </xs:sequence>
 </xs:complexType>

UICultureName: A language tag as specified in [RFC1766] section 2. Specifies the UI culture. MUST be present. MUST NOT be empty. MUST NOT be longer than 32768 characters. If the language represented by UICultureName is unsupported on the protocol server, the protocol server MAY<42> fall back to some other supported language.

DataCultureName: A language tag as specified in [RFC1766] section 2. Specifies the data culture. MUST be present. MUST NOT be empty. MUST NOT be longer than 32768 characters. The protocol server uses SharePointDataCultureName as a fallback data culture if DataCultureName is not supported.

SharePointDataCultureName: A language tag as specified in [RFC1766], section 2. Specifies the host data language. MUST be present. MUST NOT be longer than 32768 characters.

TimeZoneSerialization: The time zone of the session. MUST be present. MUST be exactly 73 characters long. MUST have the following layout, which is specified using ABNF, as specified in [RFC2234] and described in the following table.

TimeZone

=

Bias "#" StandardDate "#" StandardBias "#" DaylightDate "#" DaylightBias

Bias

=

"+"\"-" 4DIGIT

StandardDate

=

Date %d84 Time

StandardBias

=

"+"\"-" 4DIGIT

DaylightDate

=

Date %d84 Time

DaylightBias

=

"+"\"-" 4DIGIT

Date

=

Year "-" Month "-" DayOfWeek "-" Day

Time

=

Hour ":" Minute ":" Second ":" Millisecond

Year

=

4DIGIT

Month

=

2DIGIT ; 01-12

DayOfWeek

=

2DIGIT ; 00-06 (Sunday-Saturday)

Day

=

2DIGIT ; 01-31

Hour

=

2DIGIT ; 00-23

Minute

=

2DIGIT ; 00-59

Second

=

2DIGIT ; 00-59

Millisecond

=

4DIGIT

The following restrictions MUST apply on the TimeZoneSerialization:

  • Bias MUST be the time zone bias.

  • StandardDate MUST be the time zone standard date.

  • StandardBias MUST be the time zone standard bias.

  • DaylightDate MUST be the time zone daylight date.

  • DaylightBias MUST be the time zone daylight bias.

  • The following restrictions are specified in [RFC3339]:

    • Month MUST be date-month.

    • Day MUST be date-mday.

    • Hour MUST be time-hour.

    • Minute MUST time-minute.

    • Second MUST be time-second.

  • DayOfWeek MUST have one of the values described in the following table.

    Value

    Meaning

    00

    Sunday

    01

    Monday

    02

    Tuesday

    03

    Wednesday

    04

    Thursday

    05

    Friday

    06

    Saturday