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