Jump to: navigation, search

CfgTimeZone

Description

Time Zones are predefined objects that provide CTI applications with information about world time zones. Each object describes one time zone.

Filter Keys

Filter Name Type Description
dbid int A unique identifier of the time zone. If specified, Configuration Server will return information only about this time zone.
name string Name of a time zone. Shall be specified as a character string. If specified, Configuration Server will return information only about the time zone with that name.
tenant_dbid int A unique identifier of a tenant. If specified, Configuration Server will return information only about the time zone(s) that belong to this tenant.
offset int A time zone offset. If specified, Configuration Server will return information only about the time zone(s) with that offset.
name_netscape string A pointer to the time zone name used by Netscape Navigator browser. Shall be specified as a character string. If specified, Configuration Server will return information only about the time zone(s) with that name.
name_msexplorer string A pointer to the time zone name used by Microsoft browser. Shall be specified as a character string. If specified, Configuration Server will return information only about the time zone(s) with that name.
state int Current state of the time zone (see CfgObjectState). If specified, Configuration Server will return information only about the time zone(s) that are currently in this state.

Attributes

  • DBID — An identifier of this object in the Configuration Database. Generated by Configuration Server and is unique within an object type. Identifiers of deleted objects are not used again. Read-only.
  • tenantDBID — A unique identifier of the CfgTenant to which this time zone is allocated. Mandatory. Once specified, cannot be changed.
  • name — A pointer to time zone name. Mandatory. Must be unique within tenant environment.
  • description — A pointer to the time zone description.
  • offset — A time zone offset. Any integer value from -24 to 24. Must be considered as value -12 to 12 with 0.5 hour step.
  • isDSTobserved — A flag which determines whether or not DST is used. Refer to CfgFlag from User Defined Variable Types.
  • DSTStartDate — DST start date. The value is: measured in seconds if 6.0 definition schema is uses. Refer to time_t from time.h of ANSI C library. Year value range 0-2038; performed based on calculation schema. (See comments.)
  • DSTStopDate — DST stop date. The value is: measured in seconds if 6.0 definition schema is uses. Refer to time_t from time.h of ANSI C library. Year value range 0-2038; performed based on calculation schema. (See comments.)
  • DSTOffset — The value of DST offset. Default is 60 (minutes).
  • nameNetscape — A pointer to the time zone name used by Netscape Navigator browser. Mandatory.
  • nameMSExplorer — A pointer to the time zone name used by Microsoft browser. Mandatory
  • state — Current object state. Mandatory. Refer to CfgObjectState.
  • userProperties — A pointer to the list of user-defined properties. Parameter userProperties has the following structure: Each key-value pair of the primary list (TKVList *userProperties) uses the key for the name of a user-defined section, and the value for a secondary list, that also has the TKVList structure and specifies the properties defined within that section.

Comments

time_t = int or long (i.e. at least a 32-bit value)

The time_t type is logically divided into several sections that contain important information, as described by the following bit-mask:

Time_t Bit Mask Description

Bits Description Range Comments
0-3 Month 0-12
  • DST is not Observed=0
  • Jan=1 ... Dec=12
####### Week 0-5, 7
  • DST is not observed or week is not specified = 0
  • Last week of month = 7

Note:

  • The day of last week of month=week will be set to 7, if the day of week does not occur on last week
  • The day of last week of month=week will be set to 1, if the day of week does not occur on first week
####### Day 0-31, 63
  • DST is not observed = 0
  • Last day of month = 63
  • If week is specified (week!=0) the range should be 1-7
    Sun=1 ... Sat=7
13-18 Start_time, Stop_Time 0-47 in 30 minute units 1:00 am = 2
19-24 Year (shift from 2000) 0, 1-38, 39-63
  • Only if Time Zone is defined for specific Year.
  • 2001 = 1
  • DST is not observed or year is not specified=0
  • Values within range 39-63 are not valid
25-30 reserved reserved reserved
####### A flag to recognize custom/6.0 time zone reserved
  • Has to be used to distinguish custom time zones and time zones created before release 6.1:
  • New Style = 1
  • Old Style or custom time zone = 0

Definition of Time Zones for Calculation Schema

Name Description offset IsDST Month Week Date Time_start Month Week Date Time_stop Year
GMT Greenwich Mean Time 0 TRUE 3 7 1 4 10 7 1 6 0
ECT European Central Time 2 TRUE 3 7 1 4 10 7 1 6 0
EET Eastern European Time 4 TRUE 3 7 1 6 10 7 1 8 0
ART (Arabic) Egypt Standard Time 4 TRUE 4 7 6 0 9 7 6 0 0
EAT Eastern African Time 6 FALSE 0 0 0 0 0 0 0 0 0
MET Middle East Time 7 TRUE 3 0 20 0 9 0 22 0 0
NET Near East Time 8 FALSE 0 0 0 0 0 0 0 0 0
PLT Pakistan Lahore Time 10 FALSE 0 0 0 0 0 0 0 0 0
IST India Standard Time 11 FALSE 0 0 0 0 0 0 0 0 0
BST Bangladesh Standard Time 12 TRUE 3 7 1 0 10 7 1 0 0
VST Vietnam Standard Time 14 FALSE 0 0 0 0 0 0 0 0 0
CTT China Taiwan Time 16 FALSE 0 0 0 0 0 0 0 0 0
JST Japan Standard Time 18 FALSE 0 0 0 0 0 0 0 0 0
KST Korea Standard Time 18 FALSE 0 0 0 0 0 0 0 0 0
ACT Australia Central Time 19 FALSE 0 0 0 0 0 0 0 0 0
AET Australia Eastern Time 20 TRUE 8 7 7 4 3 7 1 4 0
SST Solomon Standard Time 22 FALSE 0 0 0 0 0 0 0 0 0
NST New Zealand Standard Time 24 TRUE 10 1 1 4 3 3 1 6 0
MIT Midway Islands Time -22 FALSE 0 0 0 0 0 0 0 0 0
HST Hawaii Standard Time -20 FALSE 0 0 0 0 0 0 0 0 0
AST Alaska Standard Time -18 TRUE 4 1 1 4 10 7 1 4 0
PST Pacific Standard Time -16 TRUE 4 1 1 4 10 7 1 4 0
PNT Phoenix Standard Time -14 FALSE 0 0 0 0 0 0 0 0 0
MST Mountain Standard Time -14 TRUE 4 1 1 4 10 7 1 4 0
CST Central Standard Time -12 TRUE 4 1 1 4 10 7 1 4 0
EST Eastern Standard Time -10 TRUE 4 1 1 4 10 7 1 4 0
IET Indiana Eastern Standard -10 FALSE 0 0 0 0 0 0 0 0 0
PRT Puerto Rico and US Virgin Islands Time -8 FALSE 0 0 0 0 0 0 0 0 0
CNT Canada Newfoundland Time -7 TRUE 4 1 1 4 10 7 1 4 0
AGT Argentina Standard Time -6 FALSE 0 0 0 0 0 0 0 0 0
BET Brazil Eastern Time -6 TRUE 10 2 1 0 2 7 1 0 0
CAT Central African Time -2 FALSE 0 0 0 0 0 0 0 0 0
AtlST Atlantic Standard Time -8 TRUE 4 1 1 4 10 7 1 4 0

The DSTStartTime/DSTStopTime can be calculated using function ConfCalculateTimeZone().

XML Representation

Tip
This XML was created using the Configuration Server 7.5 schema.
  <CfgTimeZone>
    <DBID value="101" />
    <tenantDBID value="1" />
    <name value="GMT" />
    <description value="Greenwich Mean Time" />
    <offset value="0" />
    <isDSTObserved value="2" />
    <DSTStartDate value="-2147450637" />
    <DSTStopDate value="-2147434246" />
    <nameNetscape value="GMT" />
    <nameMSExplorer value="GMT" />
    <state value="1" />
    <DSTOffset value="60" />
  </CfgTimeZone>

See Also

CfgDeltaTimeZone

Feedback

Comment on this article:

blog comments powered by Disqus
This page was last modified on June 27, 2017, at 12:20.