CL Command Reference - CRTTIMZON

CL Command List > CRTTIMZON Reference

Description:

The Create Time Zone Description (CRTTIMZON) command creates a time zone description object that defines the properties of a time zone. The time zone description object is created in the QSYS library. These properties are used to convert time values between Coordinated Universal Time (UTC) form and local forms. These properties are also used to express time values in local forms.

Restrictions:

. You must have read (*READ) and add (*ADD) authorities to the QSYS library.


Examples:

Example 1: Creating a Time Zone Description

CRTTIMZON TIMZON(CENTRAL) OFFSET(-360)
STDNAME(CTZ ¡¯Central Time Zone¡¯)
TEXT(¡¯Central Time Zone with Standard Time Only¡¯)

This command creates the CENTRAL time zone description. The offset for the time zone is negative six hours (-360 minutes). The Standard Time abbreviated name of the time zone is ¡¯CTZ¡¯ and the Standard Time full name of the time zone is ¡¯Central Time Zone¡¯. The text description associated with the time zone description object is ¡¯Central Time Zone with Standard Time Only¡¯. This time zone description does not observe Daylight Saving Time.



Example 2: Creating a Time Zone Description that Supports Daylight Saving Time

CRTTIMZON TIMZON(CENTRALDST) OFFSET(-360)
STDNAME(CTZ ¡¯Central Time Zone¡¯)
DSTNAME(CDTZ ¡¯Central Daylight Time Zone¡¯)
TEXT(¡¯Central Time Zone with Daylight Saving Time¡¯)
DSTSTR(*APR *SUN 1 ¡¯02:00:00¡¯)
DSTEND(*OCT *SUN *LAST ¡¯02:00:00¡¯)

This command creates the CENTRALDST time zone description. The offset for the time zone is negative six hours (-360 minutes). The Standard Time abbreviated name of the time zone is ¡¯CTZ¡¯ and the Standard Time full name of the time zone is ¡¯Central Time Zone¡¯. The Daylight Saving Time abbreviated name of the time zone is ¡¯CDTZ¡¯ and the Daylight Saving Time full name is ¡¯Central Daylight Time Zone¡¯. The text description associated with the time zone description object is ¡¯Central Time Zone with Daylight Saving Time¡¯. This time zone description does observe Daylight Saving Time. Daylight Saving Time starts at 2:00 am on the first Sunday in April and ends at 2:00 am on the last Sunday in October.