3.1.4.11.3.1 CultureCommandParameter

  • Article

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" xmlns:xs="http://www.w3.org/2001/XMLSchema">
   <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 not supported on the protocol server, the protocol server SHOULD<1> 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 Augmented Backus-Naur Form (ABNF), as specified in [RFC2234]:

    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:

  1. Bias MUST be the time zone bias.

  2. StandardDate MUST be the time zone standard date.

  3. StandardBias MUST be the time zone standard bias.

  4. DaylightDate MUST be the time zone daylight date.

  5. DaylightBias MUST be the time zone daylight bias.

  6. The following restrictions are specified in [RFC3339]:

    1. Month MUST be date-month.

    2. Day MUST be date-mday.

    3. Hour MUST be time-hour.

    4. Minute MUST time-minute.

    5. Second MUST be time-second.

  7. DayOfWeek MUST have one of the values in the following table.

    Value

    Meaning

    00

    Sunday

    01

    Monday

    02

    Tuesday

    03

    Wednesday

    04

    Thursday

    05

    Friday

    06

    Saturday