1. SuiteCloud Platform
  2. SuiteScript
  3. SuiteScript 2.x API Reference
  4. SuiteScript 2.x Modules
  5. N/format Module
  6. format.Timezone

format.Timezone

Note:

The content in this help topic pertains to SuiteScript 2.0.

Note:

JavaScript does not include an enumeration type. The SuiteScript 2.0 documentation uses the term enumeration (or enum) to describe a plain JavaScript object with a flat, map-like structure. In this object, each key points to a read-only string value.

Enum Description

Holds the string values for supported time zone formats. Use this enum to set the value of the options.timezone parameter when calling format.format(options) or format.parse(options).

Supported Script Types

Client and server scripts

For more information, see SuiteScript 2.x Script Types

Module

N/format Module

Since

2015.2

Values

This table defines all valid time zone names in Olson Value format and includes daylight savings time rules for each time zone. Olson Values are maintained by the International Assigned Numbers Authority (IANA) in an international standard time zone database. The values that populate the Time Zone dropdown list found at Home > Set Preferences are also based on these values.

When working with alternate time zones in SuiteScript, use these enumeration values. If necessary, you can use the numerical key in place of an Olson Value string. For example, to source a custom timezone dropdown list.

Key

Olson Value

Description

1

ETC_GMT_PLUS_12: 'Etc/GMT+12'

(GMT-12:00) International Date Line West

2

PACIFIC_SAMOA: 'Pacific/Samoa'

(GMT-11:00) Midway Island, Samoa

3

PACIFIC_HONOLULU: 'Pacific/Honolulu'

(GMT-10:00) Hawaii

4

AMERICA_ANCHORAGE: 'America/Anchorage'

(GMT-09:00) Alaska

5

AMERICA_LOS_ANGELES: 'America/Los_Angeles'

(GMT-08:00) Pacific Time (US & Canada)

6

AMERICA_TIJUANA: 'America/Tijuana'

(GMT-08:00) Tijuana, Baja California

7

AMERICA_DENVER: 'America/Denver'

(GMT-07:00) Mountain Time (US & Canada)

8

AMERICA_PHOENIX: 'America/Phoenix'

(GMT-07:00) Arizona

9

AMERICA_CHIHUAHUA: 'America/Chihuahua'

(GMT-07:00) Chihuahua, La Paz, Mazatlan - New

10

AMERICA_CHICAGO: 'America/Chicago'

(GMT-06:00) Central Time (US & Canada)

11

AMERICA_REGINA: 'America/Regina'

(GMT-06:00) Saskatchewan

12

AMERICA_GUATEMALA: 'America/Guatemala'

(GMT-06:00) Central America

13

AMERICA_MEXICO_CITY: 'America/Mexico_City’

(GMT-06:00) Guadalajara, Mexico City, Monterrey - Old

14

AMERICA_NEW_YORK: 'America/New_York'

(GMT-05:00) Eastern Time (US & Canada)

15

US_EAST_INDIANA: 'US/East-Indiana'

(GMT-05:00) Indiana (East)

16

AMERICA_BOGOTA: 'America/Bogota'

(GMT-05:00) Bogota, Lima, Quito

17

AMERICA_CARACAS: 'America/Caracas'

(GMT-04:30) Caracas

18

AMERICA_HALIFAX: 'America/Halifax'

(GMT-04:00) Atlantic Time (Canada)

19

AMERICA_LA_PAZ: 'America/La_Paz'

(GMT-04:00) Georgetown, La Paz, San Juan

20

AMERICA_MANAUS: 'America/Manaus'

(GMT-04:00) Manaus

21

AMERICA_SANTIAGO: 'America/Santiago'

(GMT-04:00) Santiago

22

AMERICA_ST_JOHNS: 'America/St_Johns'

(GMT-03:30) Newfoundland

23

AMERICA_SAO_PAULO: 'America/Sao_Paulo'

(GMT-03:00) Brasilia

24

AMERICA_BUENOS_AIRES: 'America/Buenos_Aires'

(GMT-03:00) Buenos Aires

25

ETC_GMT_PLUS_3: 'Etc/GMT+3'

(GMT-03:00) Cayenne

26

AMERICA_GODTHAB: 'America/Godthab'

(GMT-03:00) Greenland

27

AMERICA_MONTEVIDEO: 'America/Montevideo'

(GMT-03:00) Montevideo

28

AMERICA_NORONHA: 'America/Noronha'

(GMT-02:00) Mid-Atlantic

29

ETC_GMT_PLUS_1: 'Etc/GMT+1'

(GMT-01:00) Cabo Verde

30

ATLANTIC_AZORES: 'Atlantic/Azores'

(GMT-01:00) Azores

31

EUROPE_LONDON: 'Europe/London'

(GMT) Greenwich Mean Time : Dublin, Edinburgh, Lisbon, London

32

GMT: 'GMT'

(GMT) Casablanca

33

ATLANTIC_REYKJAVIK: 'Atlantic/Reykjavik'

(GMT) Monrovia, Reykjavik

34

EUROPE_WARSAW: 'Europe/Warsaw'

(GMT+01:00) Sarajevo, Skopje, Warsaw, Zagreb

35

EUROPE_PARIS: 'Europe/Paris'

(GMT+01:00) Brussels, Copenhagen, Madrid, Paris

36

ETC_GMT_MINUS_1: 'Etc/GMT-1'

(GMT+01:00) West Central Africa

37

EUROPE_AMSTERDAM: 'Europe/Amsterdam'

(GMT+01:00) Amsterdam, Berlin, Bern, Rome, Stockholm, Vienna

38

EUROPE_BUDAPEST: 'Europe/Budapest'

(GMT+01:00) Belgrade, Bratislava, Budapest, Ljubljana, Prague

39

AFRICA_CAIRO: 'Africa/Cairo'

(GMT+02:00) Cairo

40

EUROPE_ISTANBUL: 'Europe/Istanbul'

(GMT+02:00) Athens, Bucharest, Istanbul

41

ASIA_JERUSALEM: 'Asia/Jerusalem'

(GMT+02:00) Jerusalem

42

ASIA_AMMAN: 'Asia/Amman'

(GMT+02:00) Amman

43

ASIA_BEIRUT: 'Asia/Beirut'

(GMT+02:00) Beirut

44

AFRICA_JOHANNESBURG: 'Africa/Johannesburg'

(GMT+02:00) Harare, Pretoria

45

EUROPE_KIEV: 'Europe/Kiev'

(GMT+02:00) Helsinki, Kyiv, Riga, Sofia, Tallinn, Vilnius

46

EUROPE_MINSK: 'Europe/Minsk'

(GMT+02:00) Minsk

47

AFRICA_WINDHOEK: 'Africa/Windhoek'

(GMT+02:00) Windhoek

48

ASIA_RIYADH: 'Asia/Riyadh'

(GMT+03:00) Kuwait, Riyadh

49

EUROPE_MOSCOW: 'Europe/Moscow'

(GMT+03:00) Moscow, St. Petersburg, Volgograd

50

ASIA_BAGHDAD: 'Asia/Baghdad'

(GMT+03:00) Baghdad

51

AFRICA_NAIROBI: 'Africa/Nairobi'

(GMT+03:00) Nairobi

52

ASIA_TEHRAN: 'Asia/Tehran'

(GMT+03:30) Tehran

53

ASIA_MUSCAT: 'Asia/Muscat'

(GMT+04:00) Abu Dhabi, Muscat

54

ASIA_BAKU: 'Asia/Baku'

(GMT+04:00) Baku

55

ASIA_YEREVAN: 'Asia/Yerevan'

(GMT+04:00) Caucasus Standard Time

56

ETC_GMT_MINUS_3: 'Etc/GMT-3'

(GMT+04:00) Tbilisi

57

ASIA_KABUL: 'Asia/Kabul'

(GMT+04:30) Kabul

58

ASIA_KARACHI: 'Asia/Karachi'

(GMT+05:00) Islamabad, Karachi

59

ASIA_YEKATERINBURG: 'Asia/Yekaterinburg'

(GMT+05:00) Ekaterinburg

60

ASIA_TASHKENT: 'Asia/Tashkent'

(GMT+05:00) Tashkent

61

ASIA_CALCUTTA: 'Asia/Calcutta'

(GMT+05:30) Chennai, Kolkata, Mumbai, New Delhi

62

ASIA_KATMANDU: 'Asia/Katmandu'

(GMT+05:45) Kathmandu

63

ASIA_ALMATY: 'Asia/Almaty'

(GMT+06:00) Novosibirsk

64

ASIA_DHAKA: 'Asia/Dhaka'

(GMT+06:00) Astana, Dhaka

65

ASIA_RANGOON: 'Asia/Rangoon'

(GMT+06:30) Yangon (Rangoon)

66

ASIA_BANGKOK: 'Asia/Bangkok'

(GMT+07:00) Bangkok, Hanoi, Jakarta

67

ASIA_KRASNOYARSK: 'Asia/Krasnoyarsk'

(GMT+07:00) Krasnoyarsk

68

ASIA_HONG_KONG: 'Asia/Hong_Kong'

(GMT+08:00) Beijing, Chongqing, Hong Kong, Urumqi

69

ASIA_KUALA_LUMPUR: 'Asia/Kuala_Lumpur'

(GMT+08:00) Kuala Lumpur, Singapore

70

ASIA_TAIPEI: 'Asia/Taipei'

(GMT+08:00) Taipei

71

AUSTRALIA_PERTH: 'Australia/Perth'

(GMT+08:00) Perth

72

ASIA_IRKUTSK: 'Asia/Irkutsk'

(GMT+08:00) Irkutsk

73

ASIA_MANILA: 'Asia/Manila'

(GMT+08:00) Manila

74

ASIA_SEOUL: 'Asia/Seoul'

(GMT+09:00) Seoul

75

ASIA_TOKYO: 'Asia/Tokyo'

(GMT+09:00) Osaka, Sapporo, Tokyo

76

ASIA_YAKUTSK: 'Asia/Yakutsk'

(GMT+09:00) Yakutsk

77

AUSTRALIA_DARWIN: 'Australia/Darwin'

(GMT+09:30) Darwin

78

AUSTRALIA_ADELAIDE: 'Australia/Adelaide'

(GMT+09:30) Adelaide

79

AUSTRALIA_SYDNEY: 'Australia/Sydney'

(GMT+10:00) Canberra, Melbourne, Sydney

80

AUSTRALIA_BRISBANE: 'Australia/Brisbane'

(GMT+10:00) Brisbane

81

AUSTRALIA_HOBART: 'Australia/Hobart'

(GMT+10:00) Hobart

82

PACIFIC_GUAM: 'Pacific/Guam'

(GMT+10:00) Guam, Port Moresby

83

PACIFIC_GUADALCANA: 'Pacific/Guadalcanal'

(GMT+11:00) Guadacanal

84

ASIA_VLADIVOSTOK: 'Asia/Vladivostok'

(GMT+10:00) Vladivostok

85

PACIFIC_KWAJALEIN: 'Pacific/Kwajalein'

(GMT+12:00) Fiji, Marshall Is.

86

PACIFIC_AUCKLAND: 'Pacific/Auckland'

(GMT+12:00) Auckland, Wellington

87

PACIFIC_TONGATAPU: 'Pacific/Tongatapu'

(GMT+13:00) Nuku'alofa

Syntax

Important:

The following code sample shows the syntax for this member. It is not a functional example. For a complete script example, see N/format Module Script Samples.

            // Add additional code 
...
var date = new Date(); //Mon Aug 24 2015 17:27:16 GMT-0700 (Pacific Daylight Time)
    var TOKYO = format.format({
        value: date, 
        type: format.Type.DATETIME, 
        timezone: format.Timezone.ASIA_TOKYO   
    }); //Returns "8/25/2015 9:27:16 am"  

    var NEWYORK = format.format({
        value: date, 
        type: format.Type.DATETIME, 
        timezone: format.Timezone.AMERICA_NEW_YORK
    }); //Returns "8/24/2015 8:27:16 pm"
    
var dateStr = "03/17/2015 09:00:00 pm"
    var TOKYO_2 = format.parse({
        value: dateStr, 
        type: format.Type.DATETIME, 
        timezone: format.Timezone.ASIA_TOKYO
    }); //Returns Date object [[ Tue Mar 17 2015 05:00:00 GMT-0700 (PDT) ]]

var NEWYORK_2 = format.parse({
    value: dateStr, 
    type: format.Type.DATETIME, 
    timezone: format.Timezone.AMERICA_NEW_YORK
}); //Returns Date object [[ Tue Mar 17 2015 18:00:00 GMT-0700 (PDT) ]]
...
// Add additional code

Related Topics

N/format Module
SuiteScript 2.x Modules
SuiteScript 2.x

General Notices