一、TimeZone 类的定义

TimeZone 类位于 java.util 包中，是一个抽象类，主要包含了对于时区的各种操作，可以进行计算时间偏移量或夏令时等操作

二、TimeZone 类常用方法

getAvailableIDs()

获取Java支持的所有时区 ID

1

2

3System.out.println(Arrays.toString(TimeZone.getAvailableIDs()));

// Asia/Shanghai, Asia/Chongqing, Asia/Hong_Kong, Asia/Macao, ...

getAvailableIDs(int rawOffset)

根据 时间偏移量 来获取时区 ID

1

2

3

4

5

6

7

8// 东八区时间，与标准时间相差8小时

System.out.println(Arrays.toString(TimeZone.getAvailableIDs(8*60*60*1000)));

// [Asia/Brunei, Asia/Choibalsan, Asia/Chongqing, Asia/Chungking, Asia/Harbin,

// Asia/Hong_Kong, Asia/Irkutsk, Asia/Kuala_Lumpur, Asia/Kuching, Asia/Macao,

// Asia/Macau, Asia/Makassar, Asia/Manila, Asia/Shanghai, Asia/Singapore,

// Asia/Taipei, Asia/Ujung_Pandang, Asia/Ulaanbaatar, Asia/Ulan_Bator,

// Australia/Perth, Australia/West, CTT, Etc/GMT-8, Hongkong, PRC, Singapore]

getDefault()

获取当前系统的默认时区，中国默认为东八区

1

2

3

4System.out.println(TimeZone.getDefault());

// sun.util.calendar.ZoneInfo[id="GMT+08:00",offset=28800000,

// dstSavings=0,useDaylight=false,transitions=0,lastRule=null]

setDefault(TimeZone zone)

设置当前系统的默认时区

1

2

3

4

5TimeZone.setDefault(TimeZone.getTimeZone("Asia/Shanghai"));

System.out.println(TimeZone.getDefault());

// sun.util.calendar.ZoneInfo[id="Asia/Shanghai",offset=28800000,

// dstSavings=0,useDaylight=false,transitions=19,lastRule=null]

getTimeZone(String ID)

根据时区 ID 来获取其对应的时区

1

2

3

4System.out.println(TimeZone.getTimeZone("GMT+08:00"));

// sun.util.calendar.ZoneInfo[id="GMT+08:00",offset=28800000,

// dstSavings=0,useDaylight=false,transitions=0,lastRule=null]

getTimeZone(ZoneId zoneId)

根据 ZoneId 对象来获取其对应的时区

1

2

3

4System.out.println(TimeZone.getTimeZone(ZoneId.of("GMT+08:00")));

// sun.util.calendar.ZoneInfo[id="GMT+08:00",offset=28800000,

// dstSavings=0,useDaylight=false,transitions=0,lastRule=null]

getDisplayName()

获取该 TimeZone 对象的时区名称

1

2TimeZone timeZone = TimeZone.getTimeZone("Asia/Shanghai");

System.out.println(timeZone.getDisplayName()); // 中国标准时间

getDisplayName(Locale locale)

获取该 TimeZone 对象的时区名称，并根据 Locale 对象进行国际化

1

2

3TimeZone timeZone = TimeZone.getTimeZone("Asia/Shanghai");

System.out.println(timeZone.getDisplayName()); // 中国标准时间

System.out.println(timeZone.getDisplayName(Locale.ENGLISH)); // China Standard Time

getDisplayName(boolean daylight, int style)

获取该 TimeZone 对象的时区名称

daylight

true：指定夏令时名称

false：指定标准时间名称

style

TimeZone.LONG：显示全称

TimeZone.SHORT：显示简称

1

2

3

4TimeZone timeZone = TimeZone.getTimeZone("Asia/Shanghai");

System.out.println(timeZone.getDisplayName()); // 中国标准时间

System.out.println(timeZone.getDisplayName(false, TimeZone.LONG)); // 中国标准时间

System.out.println(timeZone.getDisplayName(false, TimeZone.SHORT)); // CST (China Standard Time)

getDisplayName(boolean daylight, int style, Locale locale)

获取该 TimeZone 对象的时区名称，并根据 Locale 对象进行国际化

daylight

true：指定夏令时名称

false：指定标准时间名称

style

TimeZone.LONG：显示全称

TimeZone.SHORT：显示简称

1

2

3TimeZone timeZone = TimeZone.getTimeZone("Asia/Shanghai");

System.out.println(timeZone.getDisplayName()); // 中国标准时间

System.out.println(timeZone.getDisplayName(false, TimeZone.LONG, Locale.ENGLISH)); // China Standard Time

getID()

获取该 TimeZone 对象的时区 ID

1

2TimeZone timeZone = TimeZone.getTimeZone("Asia/Shanghai");

System.out.println(timeZone.getID()); // Asia/Shanghai

setID(String ID)

设置该 TimeZone 对象的时区 ID

1

2

3TimeZone timeZone = TimeZone.getTimeZone("Asia/Shanghai");

timeZone.setID("Asia/Chongqing");

System.out.println(timeZone.getID()); // Asia/Chongqing

getOffset(long date)

获取该时间所在时区的时间偏移量

1

2TimeZone timeZone = TimeZone.getTimeZone("Asia/Shanghai");

System.out.println(timeZone.getOffset(System.currentTimeMillis())); // 28800000

getDSTSavings()

在夏令时规则生效时，返回相对于标准时间提前的毫秒数

如果此时区不实施夏令时，则为 0

1

2

3TimeZone timeZone = TimeZone.getTimeZone("Asia/Shanghai");

// 中国没有夏令时，故为0

System.out.println(timeZone.getDSTSavings()); // 0

getRawOffset()

获取时间原始偏移量，该值不受夏令时的影响，故称为时间原始偏移量

1

2TimeZone timeZone = TimeZone.getTimeZone("Asia/Shanghai");

System.out.println(timeZone.getRawOffset()); // 28800000

setRawOffset(int offsetMillis)

设置时间原始偏移量

1

2

3TimeZone timeZone = TimeZone.getTimeZone("Asia/Shanghai");

timeZone.setRawOffset(25200000);

System.out.println(timeZone.getRawOffset()); // 25200000

toZoneId()

将 TimeZone 对象转换为 ZoneId 对象

1

2

3TimeZone timeZone = TimeZone.getTimeZone("Asia/Shanghai");

ZoneId zoneId = timeZone.toZoneId();

System.out.println(zoneId); // Asia/Shanghai

useDaylightTime()

查询此时区是否使用夏令时

1

2TimeZone timeZone = TimeZone.getTimeZone("Asia/Shanghai");

System.out.println(timeZone.useDaylightTime()); // false

inDaylightTime(Date date)

查询给定的日期是否在此时区的夏令时中

1

2TimeZone timeZone = TimeZone.getTimeZone("Asia/Shanghai");

System.out.println(timeZone.inDaylightTime(new Date())); // false

hasSameRules(TimeZone other)

如果两时区仅时区 ID 不同，但具有相同的规则和时间偏移量，则返回 true

如果另一个时区为空，则返回 false

1

2

3TimeZone timeZone1 = TimeZone.getTimeZone("Asia/Shanghai");

TimeZone timeZone2 = TimeZone.getTimeZone("Asia/Chongqing");

System.out.println(timeZone1.hasSameRules(timeZone2)); // true