当用户所在时区和服务器所在时区不一致时,会产生时区相关问题,如时间显示错误、程序取得的时间和数据库存储的时间不一致、定时任务的触发没有跟随用户当前的时区等等问题.
统一拦截时区
/*****/
@Component
@Slf4j
public class TimeZoneIdInterceptor implements HandlerInterceptor {private static final String TIME_ZONE_CODE = "timeZoneCode";/*** 在控制器方法处理之前执行的预处理方法* <p>* 该方法用于在控制器方法执行前进行一些预处理操作,例如检查用户是否登录、记录日志等 如果该方法返回false,则表示不执行控制器方法;如果返回true,则表示继续执行控制器方法** @param request 请求对象,用于获取请求信息* @param response 响应对象,用于向客户端发送响应* @param handler 控制器方法的对象,用于执行具体的控制器方法* @return 是否执行控制器的处理逻辑,true表示执行,false表示不执行* @throws Exception 如果发生异常,将抛出异常*/@Overridepublic boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)throws Exception {//获取TimeZoneId 默认东八区String timeZoneId=request.getHeader(TIME_ZONE_CODE);if(StringUtilsPlus.isBlank(timeZoneId)){timeZoneId = ZoneIdEnum.CTT.getZoneIdName();}TimeZoneIdContext.setTimeZoneId(timeZoneId);return true;}/*** controller方法执行后* <p>* 该方法主要用于在控制器方法处理完请求后进行一些额外的处理或清理工作 它是拦截器中的一部分,用于在请求被控制器处理后立即执行自定义逻辑** @param request 请求对象,用于访问请求信息* @param response 响应对象,用于控制响应给客户端的信息* @param handler 被执行的控制器方法的引用,用于识别和可能操作控制器方法* @param modelAndView ModelAndView对象,包含要渲染的视图和模型数据* @throws Exception 如果在处理过程中发生异常,可以将其抛出*/@Overridepublic void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler,ModelAndView modelAndView) throws Exception {log.info("postHandle执行{}", modelAndView);TimeZoneIdContext.removeTimeZoneId();}}
GET请求及POST表单请求(RequestParam和PathVariable参数):
自定义spring mvc的参数解析器,配置Converter<String, T>转换器实现参数转换
@Configuration
@Slf4j
public class DateConverterConfig {/*** 创建一个字符串到LocalDateTime的转换器** 该方法通过定义一个Converter接口的匿名类来实现字符串到LocalDateTime的对象转换* 主要用于Spring框架中,以便在数据绑定、类型转换时使用** @return Converter<String, LocalDateTime> 返回一个实现了Converter接口的匿名类实例,* 用于将字符串转换为LocalDateTime对象*/@Beanpublic Converter<String, LocalDateTime> localDateTimeConverter() {return new Converter<String, LocalDateTime>() {@Overridepublic LocalDateTime convert(String source) {// String类型的日期字符串转为LocalDateTime类型,并加上时区处理// 如果源字符串不为空,则进行转换;否则返回nullif(StringUtilsPlus.isNotBlank(source)){return TimeZoneUtils.convertTimeZoneLocalDateTime(source, TimeZoneIdContext.getTimeZoneId().get(),ZoneIdEnum.CTT.getZoneIdName());}return null;}};}/*** 创建一个字符串到日期的转换器** 该方法通过定义一个Converter的Bean,实现了从字符串类型到Date类型的转换主要用于处理日期字符串,* 并考虑了时区的转换** @return Converter<String, Date> 实现了从字符串到日期的转换功能*/@Beanpublic Converter<String, Date> dateConverter() {return new Converter<String, Date>() {@Overridepublic Date convert(String source) {// String类型的日期字符串转为LocalDateTime类型,并加上时区处理if(StringUtilsPlus.isNotBlank(source)){return TimeZoneUtils.convertTimeZoneDate(source, TimeZoneIdContext.getTimeZoneId().get(),ZoneIdEnum.CTT.getZoneIdName());}return null;}};}
}
- POST-application/json请求(RequestBody参数)在使用javabean作为入参时,javabean对象中的Date、LocalDateTime类型可以根据请求头中的时区字段自动转为应用服务当前时区的时间
- 接口返回对象时,对象中的Date、LocalDateTime类型的日期值,可以根据请求头中的时区字段,自动转为该时区的时间
@JsonComponent
public class DateJsonSerializerConfig {/*** 反序列化,其它时区的时间转为本地时间*/public static class LocalDateTimeJsonDeserializer extends JsonDeserializer<LocalDateTime> {@Overridepublic LocalDateTime deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException {// 根据时区字段将日期转为本地时区时间// String类型日期转为LocalDateTime类型String timeZone = StringUtilsPlus.defaultIfEmpty(TimeZoneIdContext.getTimeZoneId().get(), ZoneIdEnum.CTT.getZoneIdName());String value = jsonParser.getValueAsString();if(StringUtilsPlus.isNotBlank(value)){return TimeZoneUtils.convertTimeZoneLocalDateTime(value,timeZone,ZoneIdEnum.CTT.getZoneIdName());}return null;}}/*** 序列化,本地时间转为其它时区的时间*/public static class LocalDateTimeJsonSerializer extends JsonSerializer<LocalDateTime> {@Overridepublic void serialize(LocalDateTime localDateTime, JsonGenerator jsonGenerator,SerializerProvider serializerProvider) throws IOException {// 本地时间转对应时区的时间String timeZone = StringUtilsPlus.defaultIfEmpty(TimeZoneIdContext.getTimeZoneId().get(), ZoneIdEnum.CTT.getZoneIdName());if(localDateTime!=null) {jsonGenerator.writeString(TimeZoneUtils.convertTimeZoneLocalDateTime(localDateTime, timeZone).format(DateTimeFormatter.ofPattern(GlobalConstants.YYYY_MM_DD_HH_MM_SS)));}}}/*** 反序列化,其它时区的时间转为本地时间*/public static class DateTimeJsonDeserializer extends JsonDeserializer<Date> {@Overridepublic Date deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException {// 根据时区字段将日期转为本地时区时间// String类型日期转为LocalDateTime类型String timeZone = StringUtilsPlus.defaultIfEmpty(TimeZoneIdContext.getTimeZoneId().get(), ZoneIdEnum.CTT.getZoneIdName());String value = jsonParser.getValueAsString();if(StringUtilsPlus.isNotBlank(value)){return TimeZoneUtils.convertTimeZoneDate(value,timeZone,ZoneIdEnum.CTT.getZoneIdName());}return null;}}/*** 序列化,本地时间转为其它时区的时间*/public static class DateTimeJsonSerializer extends JsonSerializer<Date> {@Overridepublic void serialize(Date date, JsonGenerator jsonGenerator,SerializerProvider serializerProvider) throws IOException {// 本地时间转对应时区的时间String timeZone = StringUtilsPlus.defaultIfEmpty(TimeZoneIdContext.getTimeZoneId().get(), ZoneIdEnum.CTT.getZoneIdName());if(date!=null) {jsonGenerator.writeString(DateUtil.format(TimeZoneUtils.convertTimeZoneDate(date, timeZone),GlobalConstants.YYYY_MM_DD_HH_MM_SS));}}}
}
时间时区相互转化工具类
/*** 时间时区转化**/
public class TimeZoneUtils {/**** 时间转化* 将给定的日期对象从一个时区转换到另一个时区* @param date 需要转换的日期对象* @param timeZone 目标时区* @return 转换后的日期对象,如果目标时区与默认时区相同,则返回原始日期对象*/public static Date convertTimeZoneDate(Date date, String timeZone) {// 检查目标时区是否为默认时区,如果是,则无需转换,直接返回原始日期if (isDefaultTimeZone(timeZone)) {return date;}// 获取目标时区TimeZone otherZone = TimeZone.getTimeZone(timeZone);// 创建SimpleDateFormat对象,用于日期的格式化和解析SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");// 设置SimpleDateFormat的时区为其他时区sdf.setTimeZone(otherZone);// 用于存储转换后的日期对象Date otherZoneDate = null;try {// 将格式化后的日期字符串解析为日期对象,该对象现在处于目标时区// 使用纽约时区格式化日期String dateInNewYork = sdf.format(date);otherZoneDate = DateUtil.parse(dateInNewYork,"yyyy-MM-dd HH:mm:ss");} catch (Exception e) {// 如果发生异常,打印异常信息e.printStackTrace();}// 返回转换后的日期对象return otherZoneDate;}/*** 将LocalDate对象转换为特定时区的LocalDate对象 此方法主要用于在处理不同时区的日期时进行转换,以确保日期的正确解析和表示** @param localDate 输入的LocalDate对象,表示日期* @param timeZone 目标时区的字符串表示,如"America/New_York"* @return 转换后特定时区的LocalDate对象*/public static LocalDate convertTimeZoneLocalDate(LocalDate localDate, String timeZone) {if (isDefaultTimeZone(timeZone)) {return localDate;}// 指定时区ZoneId zoneId = ZoneId.of(timeZone);// 将LocalDate转换为指定时区的ZonedDateTime 该时区一天的开始时刻的ZonedDateTime zonedDateTime = localDate.atStartOfDay(zoneId);// 返回转换后的LocalDate对象return zonedDateTime.toLocalDate();}/*** 将给定的时间字符串从一个时区转换到另一个时区* 此方法首先将时间字符串解析为本地日期时间对象,然后将其转换到源时区,* 最后将时间转换到目标时区,保持时间点不变** @param dateTimeString 时间字符串,表示源时区中的本地日期和时间* @param sourceTimeZone 源时区的ID,例如"America/New_York"* @param targetTimeZone 目标时区的ID,例如"Europe/London"* @return 转换到目标时区后的本地日期时间对象*/public static LocalDateTime convertTimeZoneLocalDateTime(String dateTimeString,String sourceTimeZone,String targetTimeZone) {// 获取源时区的ZoneId对象ZoneId sourceZoneId = ZoneId.of(sourceTimeZone);// 获取目标时区的ZoneId对象ZoneId targetZoneId = ZoneId.of(targetTimeZone);// 创建DateTimeFormatter指定日期时间格式DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss").withZone(sourceZoneId);// 解析字符串到ZonedDateTimeZonedDateTime zonedDateTimeSource = ZonedDateTime.parse(dateTimeString, formatter);// 转换到另一个时区ZonedDateTime zonedDateTimeTarget = zonedDateTimeSource.withZoneSameInstant(targetZoneId);// 将源时区应用到本地日期时间,并转换到目标时区,最后返回转换后的本地日期时间return zonedDateTimeTarget.toLocalDateTime();}/*** 转换日期时间字符串从一个时区到另一个时区* 此方法首先根据源时区解析输入的日期时间字符串,然后将其转换到目标时区* 最后返回转换后的日期时间的Date对象** @param dateTimeString 日期时间字符串,格式为"yyyy-MM-dd HH:mm:ss"* @param sourceTimeZone 源时区ID,如"Asia/Shanghai"* @param targetTimeZone 目标时区ID,如"America/New_York"* @return 转换时区后的日期时间对象*/public static Date convertTimeZoneDate(String dateTimeString,String sourceTimeZone,String targetTimeZone) {// 获取源时区的ZoneId对象ZoneId sourceZoneId = ZoneId.of(sourceTimeZone);// 获取目标时区的ZoneId对象ZoneId targetZoneId = ZoneId.of(targetTimeZone);// 创建DateTimeFormatter指定日期时间格式DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss").withZone(sourceZoneId);// 解析字符串到ZonedDateTimeZonedDateTime zonedDateTimeSource = ZonedDateTime.parse(dateTimeString, formatter);// 转换到另一个时区ZonedDateTime zonedDateTimeTarget = zonedDateTimeSource.withZoneSameInstant(targetZoneId);// 将源时区应用到本地日期时间,并转换到目标时区,最后返回转换后的本地日期时间LocalDateTime targetLocalDateTime = zonedDateTimeTarget.toLocalDateTime();Date date = Date.from(targetLocalDateTime.atZone(targetZoneId).toInstant());return date;}/*** 将LocalDateTime对象从默认时区转换到指定时区** @param localDateTime 需要转换的LocalDateTime对象* @param timeZone 目标时区的ID字符串* @return 转换后的LocalDateTime对象*/public static LocalDateTime convertTimeZoneLocalDateTime(LocalDateTime localDateTime, String timeZone) {if (isDefaultTimeZone(timeZone)) {return localDateTime;}// 默认时区ZoneId sourceZoneId = currentZoneId();ZonedDateTime sourceZonedDateTime = localDateTime.atZone(sourceZoneId);// 新时区ZoneId targetZoneId = ZoneId.of(timeZone);ZonedDateTime targetZonedDateTime = sourceZonedDateTime.withZoneSameInstant(targetZoneId);// 时区转换return targetZonedDateTime.toLocalDateTime();}/*** 是否是默认时区** @param timeZone* @return*/public static boolean isDefaultTimeZone(String timeZone) {return StringUtilsPlus.isBlank(timeZone) || currentZoneId().getId().toUpperCase().equals(timeZone.toUpperCase());}/*** 指定默认时区** @return java.time.ZoneId 返回指定的时区ID*/public static ZoneId specifyDefaultZone() {// 创建一个时区ID对象,指定时区为中国的北京时间ZoneId zoneId = ZoneId.of(ZoneIdEnum.CTT.getZoneIdName());// 返回创建的时区ID对象return zoneId;}/*** 获取当前系统的时区ID* <p>* 此方法用于识别和返回系统默认的时区ID它在需要时区信息来处理日期和时间的场景中特别有用** @return ZoneId 当前系统的时区ID*/public static ZoneId currentZoneId() {// 获取系统默认时区的时区IDZoneId systemDefaultZone = ZoneId.systemDefault();return systemDefaultZone;}/*** 指定时区获取当前日期* 此方法主要解决在不同地区运行代码时获取的日期不一致的问题* 通过指定默认时区,确保在任何地方运行都能获取到正确的日期** @return 返回指定时区的当前日期*/public static LocalDate specifyTimeZoneLocalDate() {return LocalDate.now(specifyDefaultZone());}/*** 获取指定时区的当前日期和时间* 此方法通过指定默认时区来获取当前的日期和时间,主要用于需要考虑时区的因素以确保时间一致性的场景** @return 返回指定时区的当前日期和时间*/public static LocalDateTime specifyTimeZoneLocalTimeDate() {return LocalDateTime.now(specifyDefaultZone());}/*** 获取 亚洲/上海 当前时间** 此方法旨在提供一个简单的方式来获取当前时间,并将其转换为CTT时区的时间* 它使用了更通用的convertTimeZoneLocalDateTime方法来执行实际的时区转换** @return 当前时间转换为CTT时区后的LocalDateTime*/public static LocalDateTime cttLocalDateTime() {return convertTimeZoneLocalDateTime(LocalDateTime.now(), ZoneIdEnum.CTT.getZoneIdName());}
}
参考:链接