Java时间处理----时区TimeZone类方法探究

本文转载于CSDN博主「Gene Xu」
原文链接:https://blog.csdn.net/goodbye_youth/article/details/81807273

一、TimeZone 类的定义

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

二、TimeZone 类常用方法

getAvailableIDs()

  • 获取Java支持的所有时区 ID
1
2
3
System.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
4
System.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
5
TimeZone.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
4
System.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
4
System.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
2
TimeZone timeZone = TimeZone.getTimeZone("Asia/Shanghai");
System.out.println(timeZone.getDisplayName()); // 中国标准时间

getDisplayName(Locale locale)

  • 获取该 TimeZone 对象的时区名称,并根据 Locale 对象进行国际化
1
2
3
TimeZone 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
4
TimeZone 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
3
TimeZone 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
2
TimeZone timeZone = TimeZone.getTimeZone("Asia/Shanghai");
System.out.println(timeZone.getID()); // Asia/Shanghai

setID(String ID)

  • 设置该 TimeZone 对象的时区 ID
1
2
3
TimeZone timeZone = TimeZone.getTimeZone("Asia/Shanghai");
timeZone.setID("Asia/Chongqing");
System.out.println(timeZone.getID()); // Asia/Chongqing

getOffset(long date)

  • 获取该时间所在时区的时间偏移量
1
2
TimeZone timeZone = TimeZone.getTimeZone("Asia/Shanghai");
System.out.println(timeZone.getOffset(System.currentTimeMillis())); // 28800000

getDSTSavings()

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

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

1
2
3
TimeZone timeZone = TimeZone.getTimeZone("Asia/Shanghai");
// 中国没有夏令时,故为0
System.out.println(timeZone.getDSTSavings()); // 0

getRawOffset()

  • 获取时间原始偏移量,该值不受夏令时的影响,故称为时间原始偏移量
1
2
TimeZone timeZone = TimeZone.getTimeZone("Asia/Shanghai");
System.out.println(timeZone.getRawOffset()); // 28800000

setRawOffset(int offsetMillis)

  • 设置时间原始偏移量
1
2
3
TimeZone timeZone = TimeZone.getTimeZone("Asia/Shanghai");
timeZone.setRawOffset(25200000);
System.out.println(timeZone.getRawOffset()); // 25200000

toZoneId()

  • 将 TimeZone 对象转换为 ZoneId 对象
1
2
3
TimeZone timeZone = TimeZone.getTimeZone("Asia/Shanghai");
ZoneId zoneId = timeZone.toZoneId();
System.out.println(zoneId); // Asia/Shanghai

useDaylightTime()

  • 查询此时区是否使用夏令时
1
2
TimeZone timeZone = TimeZone.getTimeZone("Asia/Shanghai");
System.out.println(timeZone.useDaylightTime()); // false

inDaylightTime(Date date)

  • 查询给定的日期是否在此时区的夏令时中
1
2
TimeZone timeZone = TimeZone.getTimeZone("Asia/Shanghai");
System.out.println(timeZone.inDaylightTime(new Date())); // false

hasSameRules(TimeZone other)

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

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

1
2
3
TimeZone timeZone1 = TimeZone.getTimeZone("Asia/Shanghai");
TimeZone timeZone2 = TimeZone.getTimeZone("Asia/Chongqing");
System.out.println(timeZone1.hasSameRules(timeZone2)); // true
---------- 😏本文结束  感谢您的阅读😏 ----------
评论