Java ZonedDateTime 类

LocalDateTime localDateTime = LocalDateTime.of(2023, 6, 15, 10, 30);
ZoneId zoneId = ZoneId.of("Europe/Paris");
ZonedDateTime parisTime = ZonedDateTime.of(localDateTime, zoneId);

常用操作方法

1. 获取时间信息

实例

ZonedDateTime zdt = ZonedDateTime.now();

int year = zdt.getYear(); // 年
Month month = zdt.getMonth(); // 月
int day = zdt.getDayOfMonth(); // 日
int hour = zdt.getHour(); // 时
int minute = zdt.getMinute(); // 分
int second = zdt.getSecond(); // 秒
ZoneId zone = zdt.getZone(); // 时区

2. 时间加减操作

实例

ZonedDateTime zdt = ZonedDateTime.now();

// 加1天
ZonedDateTime tomorrow = zdt.plusDays(1);

// 减2小时
ZonedDateTime twoHoursEarlier = zdt.minusHours(2);

// 加3周
ZonedDateTime threeWeeksLater = zdt.plusWeeks(3);

3. 时区转换

实例

ZonedDateTime tokyoTime = ZonedDateTime.now(ZoneId.of("Asia/Tokyo"));

// 转换为纽约时间
ZonedDateTime newYorkTime = tokyoTime.withZoneSameInstant(ZoneId.of("America/New_York"));

// 转换为UTC时间
ZonedDateTime utcTime = tokyoTime.withZoneSameInstant(ZoneOffset.UTC);

实际应用示例

1. 计算两个时区的时间差

实例

ZonedDateTime londonTime = ZonedDateTime.now(ZoneId.of("Europe/London"));
ZonedDateTime sydneyTime = ZonedDateTime.now(ZoneId.of("Australia/Sydney"));

// 计算小时差
long hoursBetween = ChronoUnit.HOURS.between(londonTime, sydneyTime);
System.out.println("伦敦和悉尼当前时间差: " + hoursBetween + "小时");

2. 处理跨时区的会议时间

实例

// 纽约的会议时间是下午3点
ZonedDateTime meetingTimeNY = ZonedDateTime.of(
LocalDate.now(),
LocalTime.of(15, 0),
ZoneId.of("America/New_York")
);

// 转换为东京时间
ZonedDateTime meetingTimeTokyo = meetingTimeNY.withZoneSameInstant(ZoneId.of("Asia/Tokyo"));
System.out.println("东京参会者应在当地时间: " + meetingTimeTokyo);

3. 夏令时处理

实例

// 纽约在夏令时转换前后的时间
ZonedDateTime beforeDST = ZonedDateTime.of(
LocalDateTime.of(2023, 3, 11, 1, 30),
ZoneId.of("America/New_York")
);

ZonedDateTime afterDST = beforeDST.plusHours(1);
System.out.println("实际时间差: " +
Duration.between(beforeDST, afterDST).toHours() + "小时");

ZonedDateTime 与其他日期时间类的转换

1. 转换为 Instant

实例

ZonedDateTime zdt = ZonedDateTime.now();
Instant instant = zdt.toInstant(); // 转换为UTC时间戳

2. 转换为 LocalDateTime

实例

ZonedDateTime zdt = ZonedDateTime.now();
LocalDateTime ldt = zdt.toLocalDateTime(); // 丢失时区信息

3. 从 Instant 创建

实例

Instant instant = Instant.now();
ZonedDateTime zdt = instant.atZone(ZoneId.of("Asia/Shanghai"));

综合实例

实例

import java.time.ZonedDateTime;
import java.time.ZoneId;
import java.time.format.DateTimeFormatter;

public class ZonedDateTimeDemo {
public static void main(String[] args) {
// 1. 获取当前时区的当前时间
ZonedDateTime now = ZonedDateTime.now();
System.out.println("当前时区时间: " + now);

// 2. 获取指定时区的当前时间
ZonedDateTime tokyoTime = ZonedDateTime.now(ZoneId.of("Asia/Tokyo"));
System.out.println("东京时间: " + tokyoTime);

// 3. 创建特定的带时区时间
ZonedDateTime specificTime = ZonedDateTime.of(
2023, 5, 15, 10, 30, 0, 0,
ZoneId.of("America/New_York")
);
System.out.println("纽约特定时间: " + specificTime);

// 4. 时区转换
ZonedDateTime londonTime = specificTime.withZoneSameInstant(ZoneId.of("Europe/London"));
System.out.println("对应的伦敦时间: " + londonTime);

// 5. 格式化输出
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss z");
System.out.println("格式化时间: " + now.format(formatter));

// 6. 获取各部分信息
System.out.println("时区: " + now.getZone());
System.out.println("年份: " + now.getYear());
System.out.println("月份: " + now.getMonth());
System.out.println("小时: " + now.getHour());
}
}

输出结果类似如下：

当前时区时间: 2025-05-01T11:29:07.411467+08:00[Asia/Shanghai]
东京时间: 2025-05-01T12:29:07.417938+09:00[Asia/Tokyo]
纽约特定时间: 2023-05-15T10:30-04:00[America/New_York]
对应的伦敦时间: 2023-05-15T15:30+01:00[Europe/London]
格式化时间: 2025-05-01 11:29:07 CST
时区: Asia/Shanghai
年份: 2025
月份: MAY
小时: 11

最佳实践

1.存储和传输：在数据库存储或网络传输时，建议使用 Instant 或 UTC 时间的 ZonedDateTime

2.显示：只在用户界面显示时转换为本地时区

3.比较：比较不同时区的时间时，先转换为同一时区或 Instant

4.夏令时：始终使用完整的时区ID(如"America/New_York")而非简单的偏移量(如"-05:00")

ZonedDateTime 是处理时区敏感应用程序的强大工具，正确使用可以避免许多常见的日期时间问题。

静态工厂方法

方法	描述	示例
static ZonedDateTime now()	获取当前时区的当前日期时间	ZonedDateTime.now()
static ZonedDateTime now(ZoneId zone)	获取指定时区的当前日期时间	ZonedDateTime.now(ZoneId.of("Asia/Shanghai"))
static ZonedDateTime of(int year, int month, int day, int hour, int minute, int second, int nano, ZoneId zone)	指定参数创建	ZonedDateTime.of(2023, 6, 15, 14, 30, 0, 0, ZoneId.of("GMT+8"))
static ZonedDateTime of(LocalDate date, LocalTime time, ZoneId zone)	组合LocalDate、LocalTime和时区创建	ZonedDateTime.of(LocalDate.now(), LocalTime.now(), ZoneId.systemDefault())
static ZonedDateTime of(LocalDateTime localDateTime, ZoneId zone)	从LocalDateTime和时区创建	ZonedDateTime.of(LocalDateTime.now(), ZoneId.of("America/New_York"))
static ZonedDateTime ofInstant(Instant instant, ZoneId zone)	从Instant和时区创建	ZonedDateTime.ofInstant(Instant.now(), ZoneId.of("UTC"))
static ZonedDateTime parse(CharSequence text)	从字符串解析	ZonedDateTime.parse("2023-06-15T14:30:45+08:00[Asia/Shanghai]")
static ZonedDateTime parse(CharSequence text, DateTimeFormatter formatter)	使用指定格式解析	ZonedDateTime.parse("2023-06-15 14:30 CST", DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm z"))

获取日期时间信息

方法	描述	示例
int getYear()	获取年份	2023
Month getMonth()	获取月份（Month枚举）	Month.JUNE
int getMonthValue()	获取月份值（1-12	6
int getDayOfMonth()	获取月中的天数	15
int getDayOfYear()	获取年中的天数	166
DayOfWeek getDayOfWeek()	获取星期几（DayOfWeek枚举）	DayOfWeek.THURSDAY
int getHour()	获取小时（0-23）	14
int getMinute()	获取分钟（0-59）	30
int getSecond()	获取秒数（0-59）	45
int getNano()	获取纳秒数	0
ZoneId getZone()	获取时区	Asia/Shanghai
ZoneOffset getOffset()	获取时区偏移量	+08:00

日期时间操作

方法	描述	示例
ZonedDateTime plusDays(long days)	添加天数	zdt.plusDays(5)
ZonedDateTime plusHours(long hours)	添加小时	zdt.plusHours(2)
ZonedDateTime plusMinutes(long minutes)	添加分钟	zdt.plusMinutes(30)
ZonedDateTime plusSeconds(long seconds)	添加秒数	zdt.plusSeconds(45)
ZonedDateTime plusNanos(long nanos)	添加纳秒	zdt.plusNanos(1000000)
ZonedDateTime minusDays(long days)	减去天数	zdt.minusDays(5)
ZonedDateTime minusHours(long hours)	减去小时	zdt.minusHours(2)
ZonedDateTime minusMinutes(long minutes)	减去分钟	zdt.minusMinutes(30)
ZonedDateTime minusSeconds(long seconds)	减去秒数	zdt.minusSeconds(45)
ZonedDateTime minusNanos(long nanos)	减去纳秒	zdt.minusNanos(1000000)
ZonedDateTime withYear(int year)	修改年份	zdt.withYear(2024)
ZonedDateTime withMonth(int month)	修改月份	zdt.withMonth(12)
ZonedDateTime withDayOfMonth(int day)	修改月中的天数	zdt.withDayOfMonth(1)
ZonedDateTime withHour(int hour)	修改小时	zdt.withHour(0)
ZonedDateTime withMinute(int minute)	修改分钟	zdt.withMinute(0)
ZonedDateTime withSecond(int second)	修改秒数	zdt.withSecond(0)
ZonedDateTime withNano(int nano)	修改纳秒	zdt.withNano(0)
ZonedDateTime withZoneSameInstant(ZoneId zone)	转换时区（保持同一时刻）	zdt.withZoneSameInstant(ZoneId.of("UTC"))
ZonedDateTime withZoneSameLocal(ZoneId zone)	转换时区（保持本地时间）	zdt.withZoneSameLocal(ZoneId.of("UTC"))

转换方法

方法	描述	示例
LocalDate toLocalDate()	转换为LocalDate	zdt.toLocalDate()
LocalTime toLocalTime()	转换为LocalTime	zdt.toLocalTime()
LocalDateTime toLocalDateTime()	转换为LocalDateTime	zdt.toLocalDateTime()
OffsetDateTime toOffsetDateTime()	转换为OffsetDateTime	zdt.toOffsetDateTime()
Instant toInstant()	转换为Instant	zdt.toInstant()

比较方法

方法	描述	示例
boolean isAfter(ChronoZonedDateTime<?> other)	是否在指定日期时间之后	zdt1.isAfter(zdt2)
boolean isBefore(ChronoZonedDateTime<?> other)	是否在指定日期时间之前	zdt1.isBefore(zdt2)
boolean isEqual(ChronoZonedDateTime<?> other)	是否等于指定日期时间	zdt1.isEqual(zdt2)
int compareTo(ChronoZonedDateTime<?> other)	比较两个日期时间	zdt1.compareTo(zdt2)

格式化与字符串转换

方法	描述	示例
String format(DateTimeFormatter formatter)	格式化为字符串	zdt.format(DateTimeFormatter.ISO_ZONED_DATE_TIME)
String toString()	转换为ISO格式字符串	"2023-06-15T14:30:45+08:00[Asia/Shanghai]"

29 次浏览	1次

< 首页

< 下一页