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:

JavaScript does not include an enumeration type. The SuiteScript 2.x 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).

Module

N/format Module

Sibling Module Members

N/format Module Members

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'

Don't use this: Choose (GMT-06:00) Central America, Chihuahua or (GMT-07:00) La Paz, Hermosillo

10

AMERICA_HERMOSILLO: 'America/Hermosillo'

(GMT-07:00) La Paz, Hermosillo

11

AMERICA_CHICAGO: 'America/Chicago'

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

12

AMERICA_REGINA: 'America/Regina'

(GMT-06:00) Saskatchewan

13

AMERICA_GUATEMALA: 'America/Guatemala'

(GMT-06:00) Central America, Chihuahua

14

AMERICA_MEXICO_CITY: 'America/Mexico_City’

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

15

AMERICA_NEW_YORK: 'America/New_York'

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

16

US_EAST_INDIANA: 'US/East-Indiana'

(GMT-05:00) Indiana (East)

17

AMERICA_BOGOTA: 'America/Bogota'

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

18

AMERICA_CARACAS: 'America/Caracas'

(GMT-04:30) Caracas

19

AMERICA_HALIFAX: 'America/Halifax'

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

20

AMERICA_LA_PAZ: 'America/La_Paz'

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

21

AMERICA_MANAUS: 'America/Manaus'

(GMT-04:00) Manaus

22

AMERICA_SANTIAGO: 'America/Santiago'

(GMT-04:00) Santiago

23

AMERICA_ST_JOHNS: 'America/St_Johns'

(GMT-03:30) Newfoundland

24

AMERICA_SAO_PAULO: 'America/Sao_Paulo'

(GMT-03:00) Brasilia

25

AMERICA_BUENOS_AIRES: 'America/Buenos_Aires'

(GMT-03:00) Buenos Aires

26

ETC_GMT_PLUS_3: 'Etc/GMT+3'

(GMT-03:00) Cayenne

27

AMERICA_GODTHAB: 'America/Godthab'

(GMT-03:00) Greenland

28

AMERICA_MONTEVIDEO: 'America/Montevideo'

(GMT-03:00) Montevideo

29

AMERICA_NORONHA: 'America/Noronha'

(GMT-02:00) Mid-Atlantic

30

ETC_GMT_PLUS_1: 'Etc/GMT+1'

(GMT-01:00) Cabo Verde

31

ATLANTIC_AZORES: 'Atlantic/Azores'

(GMT-01:00) Azores

32

EUROPE_LONDON: 'Europe/London'

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

33

GMT: 'GMT'

(GMT) Casablanca

34

ATLANTIC_REYKJAVIK: 'Atlantic/Reykjavik'

(GMT) Monrovia, Reykjavik

35

EUROPE_WARSAW: 'Europe/Warsaw'

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

36

EUROPE_PARIS: 'Europe/Paris'

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

37

ETC_GMT_MINUS_1: 'Etc/GMT-1'

(GMT+01:00) West Central Africa

38

EUROPE_AMSTERDAM: 'Europe/Amsterdam'

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

39

EUROPE_BUDAPEST: 'Europe/Budapest'

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

40

AFRICA_CAIRO: 'Africa/Cairo'

(GMT+02:00) Cairo

41

EUROPE_ISTANBUL: 'Europe/Istanbul'

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

42

ASIA_JERUSALEM: 'Asia/Jerusalem'

(GMT+02:00) Jerusalem

43

ASIA_AMMAN: 'Asia/Amman'

(GMT+02:00) Amman

44

ASIA_BEIRUT: 'Asia/Beirut'

(GMT+02:00) Beirut

45

AFRICA_JOHANNESBURG: 'Africa/Johannesburg'

(GMT+02:00) Harare, Pretoria

46

EUROPE_KIEV: 'Europe/Kiev'

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

47

EUROPE_MINSK: 'Europe/Minsk'

(GMT+02:00) Minsk

48

AFRICA_WINDHOEK: 'Africa/Windhoek'

(GMT+02:00) Windhoek

49

ASIA_RIYADH: 'Asia/Riyadh'

(GMT+03:00) Kuwait, Riyadh

50

EUROPE_MOSCOW: 'Europe/Moscow'

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

51

ASIA_BAGHDAD: 'Asia/Baghdad'

(GMT+03:00) Baghdad

52

AFRICA_NAIROBI: 'Africa/Nairobi'

(GMT+03:00) Nairobi

53

ASIA_TEHRAN: 'Asia/Tehran'

(GMT+03:30) Tehran

54

ASIA_MUSCAT: 'Asia/Muscat'

(GMT+04:00) Abu Dhabi, Muscat

55

ASIA_BAKU: 'Asia/Baku'

(GMT+04:00) Baku

56

ASIA_YEREVAN: 'Asia/Yerevan'

(GMT+04:00) Caucasus Standard Time

57

ETC_GMT_MINUS_3: 'Etc/GMT-3'

(GMT+04:00) Tbilisi

58

ASIA_KABUL: 'Asia/Kabul'

(GMT+04:30) Kabul

59

ASIA_KARACHI: 'Asia/Karachi'

(GMT+05:00) Islamabad, Karachi

60

ASIA_YEKATERINBURG: 'Asia/Yekaterinburg'

(GMT+05:00) Ekaterinburg

61

ASIA_TASHKENT: 'Asia/Tashkent'

(GMT+05:00) Tashkent

62

ASIA_CALCUTTA: 'Asia/Calcutta'

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

63

ASIA_KATMANDU: 'Asia/Katmandu'

(GMT+05:45) Kathmandu

64

ASIA_ALMATY: 'Asia/Almaty'

(GMT+06:00) Novosibirsk

65

ASIA_DHAKA: 'Asia/Dhaka'

(GMT+06:00) Astana, Dhaka

66

ASIA_RANGOON: 'Asia/Rangoon'

(GMT+06:30) Yangon (Rangoon)

67

ASIA_BANGKOK: 'Asia/Bangkok'

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

68

ASIA_KRASNOYARSK: 'Asia/Krasnoyarsk'

(GMT+07:00) Krasnoyarsk

69

ASIA_HONG_KONG: 'Asia/Hong_Kong'

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

70

ASIA_KUALA_LUMPUR: 'Asia/Kuala_Lumpur'

(GMT+08:00) Kuala Lumpur, Singapore

71

ASIA_TAIPEI: 'Asia/Taipei'

(GMT+08:00) Taipei

72

AUSTRALIA_PERTH: 'Australia/Perth'

(GMT+08:00) Perth

73

ASIA_IRKUTSK: 'Asia/Irkutsk'

(GMT+08:00) Irkutsk

74

ASIA_MANILA: 'Asia/Manila'

(GMT+08:00) Manila

75

ASIA_SEOUL: 'Asia/Seoul'

(GMT+09:00) Seoul

76

ASIA_TOKYO: 'Asia/Tokyo'

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

77

ASIA_YAKUTSK: 'Asia/Yakutsk'

(GMT+09:00) Yakutsk

78

AUSTRALIA_DARWIN: 'Australia/Darwin'

(GMT+09:30) Darwin

79

AUSTRALIA_ADELAIDE: 'Australia/Adelaide'

(GMT+09:30) Adelaide

80

AUSTRALIA_SYDNEY: 'Australia/Sydney'

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

81

AUSTRALIA_BRISBANE: 'Australia/Brisbane'

(GMT+10:00) Brisbane

82

AUSTRALIA_HOBART: 'Australia/Hobart'

(GMT+10:00) Hobart

83

PACIFIC_GUAM: 'Pacific/Guam'

(GMT+10:00) Guam, Port Moresby

84

PACIFIC_GUADALCANA: 'Pacific/Guadalcanal'

(GMT+11:00) Guadacanal

85

ASIA_VLADIVOSTOK: 'Asia/Vladivostok'

(GMT+10:00) Vladivostok

86

PACIFIC_KWAJALEIN: 'Pacific/Kwajalein'

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

87

PACIFIC_AUCKLAND: 'Pacific/Auckland'

(GMT+12:00) Auckland, Wellington

88

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

General Notices