Timezone

Sets the time zone that is used in the script.

Dependencies

  • The default time zone set in your business unit is automatically used and takes precedence unless you set a different timezone with a Timezone action in your script.
  • Use Timezone before the Hours action in your script.
  • Individual regions, countries, or cities within a time zone can vary in how, when, and whether they observe Daylight Savings Time (DST). This information changes often. For this reason, the online help cannot list all current variations within a timezone. It's the customer's responsibility to understand how DST is observed in the locations where they operate.

Supported Script Types

The icon for a Generic script type - a rectangle with < and > symbols inside it.

The icon for the Email script type - a large @ symbol in a diamond.

The icon for the Chat script type - a chat bubble with an ellipsis inside (...), in a diamond shape.

The icon for the Phone script type - an old-style phone handset with curved lines indicating sound coming out of it.

The icon for the Voicemail script type - a symbol that looks like a cassette tape - two circles sitting on a horizontal line.

The icon for the Work Item script type-a piece of paper with one corner folded down and a bullet list on it.

The icon for the SMS script type - a smart phone with a chat bubble coming out of it.

The icon for the Digital script type - a computer monitor with a smartphone next to it.

Generic

Email Chat Phone Voicemail Work Item SMS Digital

 

Script Example

This is an example to show how this action can be used in scripts. It is not intended to be a complete script. Additional scripting may be required.

In this basic partial phone script example, Begin triggers the script, which then uses the TimeZone property (in the Timezone action) to set the timezone to Eastern Standard Time. The script then uses the Hours of Operation profile (created in the Hours action) to determine if the contact center is open or not. If it is open, a Menu will provide options for the caller.

Download this script.

TimeZone Property Option

The following table describes the time zones available in the TimeZone property of the Timezone action. In this table: 

  • The names in the Option column match the names of the time zone options in the TimeZone property. The order of the options in the table reflect the order in the property list.

  • The options in this list do not strictly adhere to the time zones found in other lists available on the internet.

    For example, the list contains the following options: Mountain Standard Time and US Mountain Standard Time. The second option is only for Arizona, while the first is for all other states within the Mountain Standard Time zone. In other time zone lists, there is only one time zone listing for this region of the United States.

  • The option names do not match the time zone labels displayed in the CXone platform, such as in Personal Connection or in the business unit configurations.
  • The DST Observed by Action column indicates whether the Timezone action applies a change to that time zone during Daylight Savings Time (DST).
  • The Notes column provides additional information about each time zone option, including its UTC offset. The listed UTC offset is the offset that the Timezone action applies to each time zone when DST is not in effect. For time zone options that the action applies DST changes to, the UTC offset is one hour more than the stated offset when DST is in effect.
  • All other information in the Notes column comes from outside of the Studio action.

Always use a source outside of the online help to verify the time zone and DST observation of the locations where your organization operates. This information changes often and NICE CXone cannot guarantee that the Timezone action has been updated or that the information in the online help is current.

Test your selected time zone to verify that it provides the time and DST observation that you require. It may be necessary to adjust your script to achieve the results you need when using the Timezone action.

Option DST Applied by Action Notes
Dateline Standard Time No

UTC-12

UTC-11 No New Zealand, American Samoa
Aleutian Standard Time Yes

UTC-10

Hawaiian Standard Time No UTC-10
Marquesas Standard Time No UTC-9:30
Alaskan Standard Time Yes

UTC-9

UTC-09 No Cook Islands, French Polynesia
Pacific Standard Time (Mexico) Yes

UTC-08

UTC-08 No Pitcairn Islands, Anchorage, Alaska USA
Pacific Standard Time Yes

UTC-08

US Mountain Standard Time No

UTC-07

Use this time zone option for Arizona only. Use the Mountain Standard Time option for all other US states in the Mountain Standard time zone.

Mountain Standard Time (Mexico) No UTC-07
Mountain Standard Time Yes

UTC-07

For Arizona, use the US Mountain Standard Time option instead.

Yukon Standard Time No UTC-07
Central America Standard Time No UTC-06
Central Standard Time Yes UTC-06
Easter Island Standard Time No UTC-06
Central Standard Time (Mexico) No UTC-06
Canada Central Standard Time No UTC-06
SA Pacific Standard Time No UTC-05
Eastern Standard Time (Mexico) No UTC-05
Eastern Standard Time Yes UTC-05
Haiti Standard Time Yes UTC-05
Cuba Standard Time Yes UTC-05
US Eastern Standard Time Yes UTC-05
Turks and Caicos Standard Time No UTC-04
Paraguay Standard Time No UTC-04
Atlantic Standard Time Yes UTC-04
Venezuela Standard Time No UTC-04
Central Brazilian Standard Time No UTC-04
SA Western Standard Time No UTC-04
Pacific SA Standard Time Yes UTC-04
Newfoundland Standard Time No UTC-3:30
Tocantins Standard Time No UTC-03
E. South America Standard Time No

UTC-03

SA Eastern Standard Time No UTC-03
Argentina Standard Time No UTC-03
Greenland Standard Time Yes UTC-03
Montevideo Standard Time No UTC-03
Magallanes Standard Time No UTC-03
Saint Pierre Standard Time Yes UTC-03
Bahia Standard Time No UTC-03
UTC-02 No Brazil, Saint Pierre and Miquelon, South Georgia and the Sandwich Islands
Mid-Atlantic Standard Time Yes UTC-02
Azores Standard Time Yes UTC-01
Cape Verde Standard Time No UTC-01
UTC No

UTC-00

GMT Standard Time No UTC+01
Greenwich Standard Time No UTC-00
Sao Tome Standard Time No UTC-00
Morocco Standard Time Yes

UTC+01

W. Europe Standard Time Yes UTC+01
Central Europe Standard Time Yes UTC+01
Romance Standard Time Yes UTC+01
Central European Standard Time Yes UTC+01
W. Central Africa Standard Time No UTC+01
GTB Standard Time Yes UTC+02
Middle East Standard Time No

UTC+03

Egypt Standard Time Yes UTC+02
E. Europe Standard Time Yes UTC+02
Syria Standard Time Yes UTC+02
West Bank Standard Time Yes UTC+02
South Africa Standard Time No UTC+02
FLE Standard Time Yes UTC+02
Israel Standard Time Yes UTC+02
South Sudan Standard Time No UTC+02
Kaliningrad Standard Time No UTC+02
Sudan Standard Time No UTC+02
Libya Standard Time No UTC+02
Namibia Standard Time No UTC+02
Jordan Standard Time Yes UTC+03
Arabic Standard Time No UTC+03
Turkey Standard Time No UTC+03
Arab Standard Time No

UTC+03

Belarus Standard Time No UTC+03
Russian Standard Time No UTC+03
E. Africa Standard Time No UTC+03
Volgograd Standard Time No UTC+04
Iran Standard Time No UTC+03:30
Arabian Standard Time No UTC+04
Astrakhan Standard Time No UTC+04
Azerbaijan Standard Time No UTC+04
Russian Time Zone 3 No UTC+04
Mauritius Standard Time No UTC+04
Saratov Standard Time No UTC+04
Georgian Standard Time No UTC+04
Caucasus Standard Time No UTC+04
Afghanistan Standard Time No UTC+4:30
West Asia Standard Time No UTC+05
Ekaterinburg Standard Time No UTC+05
Pakistan Standard Time No UTC+05
Qyzylorda Standard Time No UTC+05
India Standard Time No UTC+5:30
Sri Lanka Standard Time No UTC+5:30
Nepal Standard Time No UTC+5:45
Central Asia Standard Time No UTC+06
Bangladesh Standard Time No UTC+06
Omsk Standard Time No UTC+06
Myanmar Standard Time No UTC+6:30
SE Asia Standard Time No UTC+07
Altai Standard Time No UTC+07
W. Mongolia Standard Time No UTC+07
North Asia Standard Time No UTC+07
N. Central Asia Standard Time No UTC+07
Tomsk Standard Time No UTC+07
China Standard Time No UTC+08
North Asia East Standard Time Yes UTC+07
Singapore Standard Time No UTC+08
W. Australia Standard Time No UTC+08
Taipei Standard Time No UTC+08
Ulaanbaatar Standard Time No UTC+08
Aus Central W. Standard Time No UTC+8:45
Transbaikal Standard Time No UTC+09
Tokyo Standard Time No UTC+09
North Korea Standard Time No UTC+09
Korea Standard Time No

UTC+09

Yakutsk Standard Time No UTC+09
Cen. Australia Standard Time Yes

UTC+9:30

AUS Central Standard Time No

UTC+9:30

E. Australia Standard Time No

UTC+10

AUS Eastern Standard Time Yes

UTC+10

West Pacific Standard Time No UTC+10
Tasmania Standard Time No UTC+10
Vladivostok Standard Time No UTC+10
Lord Howe Standard Time Yes UTC+10:30
Bougainville Standard Time No UTC+11
Russia Time Zone 10 No UTC+11
Magadan Standard Time No

UTC+11

Norfolk Standard Time No UTC+11
Sakhalin Standard Time No UTC+11
Central Pacific Standard Time No UTC+11
Russia Time Zone 11 No UTC+12
New Zealand Standard Time Yes UTC+12
UTC+12 No Fiji, Marshall Islands, Naru, Tuvalu, Wallis and Futuna
Fiji Standard Time No UTC+12
Kamchatka Standard Time Yes UTC+12
Chatham Islands Standard Time No UTC+12:45
UTC+13 No Samoa, Tokelau, Tonga
Tonga Standard Time No UTC+13
Samoa Standard Time No UTC+13
Line Islands Standard Time No UTC+14