我一直在Java EE应用程序中使用Joda Time进行日期时间操作,其中关联客户端提交的日期时间的字符串表示在将其提交到数据库之前已使用以下转换例程进行转换,即在JSF转换器的getAsObject()
方法中。
org.joda.time.format.DateTimeFormatter formatter = org.joda.time.format.DateTimeFormat.forPattern("dd-MMM-yyyy hh:mm:ss a Z").withZone(DateTimeZone.UTC);
DateTime dateTime = formatter.parseDateTime("05-Jan-2016 03:04:44 PM +0530");
System.out.println(formatter.print(dateTime));
给出的当地时区比 UTC
/GMT
快 5 小时 和 30 分钟。因此,转换为UTC
应从给定的日期时间中扣除 5 小时 30 分钟,该日期时间使用 Joda Time 正确发生。它按预期显示以下输出。
05-Jan-2016 09:34:44 AM +0000
► 已采用时区偏移量+0530
代替+05:30
,因为它取决于以这种格式提交区域偏移量<p:calendar>
。似乎不可能改变<p:calendar>
的这种行为(否则就不需要这个问题本身)。
然而,如果尝试在Java 8中使用Java Time API,同样的事情会被破坏。
java.time.format.DateTimeFormatter formatter = java.time.format.DateTimeFormatter.ofPattern("dd-MMM-yyyy hh:mm:ss a Z").withZone(ZoneOffset.UTC);
ZonedDateTime dateTime = ZonedDateTime.parse("05-Jan-2016 03:04:44 PM +0530", formatter);
System.out.println(formatter.format(dateTime));
它意外地显示以下不正确的输出。
05-Jan-2016 03:04:44 PM +0000
显然,转换的日期时间不是根据它应该转换的UTC
。
它需要采用以下更改才能正常工作。
java.time.format.DateTimeFormatter formatter = java.time.format.DateTimeFormatter.ofPattern("dd-MMM-yyyy hh:mm:ss a z").withZone(ZoneOffset.UTC);
ZonedDateTime dateTime = ZonedDateTime.parse("05-Jan-2016 03:04:44 PM +05:30", formatter);
System.out.println(formatter.format(dateTime));
这反过来显示以下内容。
05-Jan-2016 09:34:44 AM Z
Z
已替换为z
,+0530
已替换为+05:30
。
为什么这两个 API 在这方面具有不同的行为,在这个问题上被全心全意地忽略了。
对于Java 8中的<p:calendar>
和Java Time,可以考虑哪种中间方法,尽管<p:calendar>
内部使用SimpleDateFormat
和java.util.Date
,但可以一致和连贯地工作?
JSF 中不成功的测试场景。
转换器 :
@FacesConverter("dateTimeConverter")
public class DateTimeConverter implements Converter {
@Override
public Object getAsObject(FacesContext context, UIComponent component, String value) {
if (value == null || value.isEmpty()) {
return null;
}
try {
return ZonedDateTime.parse(value, DateTimeFormatter.ofPattern("dd-MMM-yyyy hh:mm:ss a Z").withZone(ZoneOffset.UTC));
} catch (IllegalArgumentException | DateTimeException e) {
throw new ConverterException(new FacesMessage(FacesMessage.SEVERITY_ERROR, null, "Message"), e);
}
}
@Override
public String getAsString(FacesContext context, UIComponent component, Object value) {
if (value == null) {
return "";
}
if (!(value instanceof ZonedDateTime)) {
throw new ConverterException("Message");
}
return DateTimeFormatter.ofPattern("dd-MMM-yyyy hh:mm:ss a z").withZone(ZoneId.of("Asia/Kolkata")).format(((ZonedDateTime) value));
// According to a time zone of a specific user.
}
}
XHTML具有<p:calendar>
.
<p:calendar id="dateTime"
timeZone="Asia/Kolkata"
pattern="dd-MMM-yyyy hh:mm:ss a Z"
value="#{bean.dateTime}"
showOn="button"
required="true"
showButtonPanel="true"
navigator="true">
<f:converter converterId="dateTimeConverter"/>
</p:calendar>
<p:message for="dateTime"/>
<p:commandButton value="Submit" update="display" actionListener="#{bean.action}"/><br/><br/>
<h:outputText id="display" value="#{bean.dateTime}">
<f:converter converterId="dateTimeConverter"/>
</h:outputText>
时区完全透明地取决于用户的当前时区。
豆子除了一个属性之外什么都没有。
@ManagedBean
@ViewScoped
public class Bean implements Serializable {
private ZonedDateTime dateTime; // Getter and setter.
private static final long serialVersionUID = 1L;
public Bean() {}
public void action() {
// Do something.
}
}
这将以意想不到的方式工作,如前三个代码片段中的倒数第二个示例/中间所示。
具体来说,如果输入 05-Jan-2016 12:00:00 AM +0530
,它将重新显示05-Jan-2016 05:30:00 AM IST
,因为转换器中05-Jan-2016 12:00:00 AM +0530
到UTC
的原始转换失败。
从偏移量+05:30
到UTC
的本地时区转换,然后从UTC
转换回该时区,显然必须重新显示通过日历组件输入的相同日期时间,这是给定转换器的基本功能。
更新:
在java.sql.Timestamp
和java.time.ZonedDateTime
之间转换的JPA转换器。
import java.sql.Timestamp;
import java.time.ZoneOffset;
import java.time.ZonedDateTime;
import javax.persistence.AttributeConverter;
import javax.persistence.Converter;
@Converter(autoApply = true)
public final class JodaDateTimeConverter implements AttributeConverter<ZonedDateTime, Timestamp> {
@Override
public Timestamp convertToDatabaseColumn(ZonedDateTime dateTime) {
return dateTime == null ? null : Timestamp.from(dateTime.toInstant());
}
@Override
public ZonedDateTime convertToEntityAttribute(Timestamp timestamp) {
return timestamp == null ? null : ZonedDateTime.ofInstant(timestamp.toInstant(), ZoneOffset.UTC);
}
}
DateTime
迁移到 Java8 的分区日期时间实例ZonedDateTime
而不是 Java8 的无区域日期时间实例LocalDateTime
。
使用 ZonedDateTime
(或 OffsetDateTime
)而不是 LocalDateTime
至少需要 2 项其他更改:
不要在日期时间转换期间强制使用时区(偏移量)。相反,在解析过程中将使用输入字符串的时区(如果有),并且在格式化期间必须使用存储在实例
ZonedDateTime
时区。DateTimeFormatter#withZone()
只会在ZonedDateTime
时给出令人困惑的结果,因为它将在解析期间充当回退(仅在输入字符串或格式模式中没有时区时使用),并且它将在格式化期间充当覆盖(存储在ZonedDateTime
中的时区被完全忽略)。这是可观察到问题的根本原因。在创建格式化程序时省略withZone()
应该可以修复它。请注意,当您指定了转换器并且没有
timeOnly="true"
时,则无需指定<p:calendar timeZone>
。即使这样做,您也宁愿使用TimeZone.getTimeZone(zonedDateTime.getZone())
而不是硬编码它。您需要在所有图层(包括数据库)上携带时区(偏移量)。但是,如果您的数据库具有"没有时区的日期时间"列类型,则时区信息在持久化期间会丢失,并且在从数据库发回时会遇到麻烦。
目前还不清楚您使用的是哪个数据库,但请记住,某些数据库不支持 Oracle 和 PostgreSQL 数据库中已知的
TIMESTAMP WITH TIME ZONE
列类型。例如,MySQL不支持它。您需要第二列。
如果这些更改不可接受,则需要返回到LocalDateTime
,并依赖所有层(包括数据库)的固定/预定义时区。通常使用UTC来表示。
处理 JSF 和 JPA 中的ZonedDateTime
将 ZonedDateTime
与适当的 TIMESTAMP WITH TIME ZONE
DB 列类型一起使用时,请使用下面的 JSF 转换器在 UI 中的String
和模型中的ZonedDateTime
之间进行转换。此转换器将从父组件中查找pattern
和locale
属性。如果父组件本身不支持 pattern
或 locale
属性,只需将它们添加为 <f:attribute name="..." value="...">
。如果 locale
属性不存在,则将改用(默认)<f:view locale>
。如上面的 #1 中所述,原因没有timeZone
属性。
@FacesConverter(forClass=ZonedDateTime.class)
public class ZonedDateTimeConverter implements Converter {
@Override
public String getAsString(FacesContext context, UIComponent component, Object modelValue) {
if (modelValue == null) {
return "";
}
if (modelValue instanceof ZonedDateTime) {
return getFormatter(context, component).format((ZonedDateTime) modelValue);
} else {
throw new ConverterException(new FacesMessage(modelValue + " is not a valid ZonedDateTime"));
}
}
@Override
public Object getAsObject(FacesContext context, UIComponent component, String submittedValue) {
if (submittedValue == null || submittedValue.isEmpty()) {
return null;
}
try {
return ZonedDateTime.parse(submittedValue, getFormatter(context, component));
} catch (DateTimeParseException e) {
throw new ConverterException(new FacesMessage(submittedValue + " is not a valid zoned date time"), e);
}
}
private DateTimeFormatter getFormatter(FacesContext context, UIComponent component) {
return DateTimeFormatter.ofPattern(getPattern(component), getLocale(context, component));
}
private String getPattern(UIComponent component) {
String pattern = (String) component.getAttributes().get("pattern");
if (pattern == null) {
throw new IllegalArgumentException("pattern attribute is required");
}
return pattern;
}
private Locale getLocale(FacesContext context, UIComponent component) {
Object locale = component.getAttributes().get("locale");
return (locale instanceof Locale) ? (Locale) locale
: (locale instanceof String) ? new Locale((String) locale)
: context.getViewRoot().getLocale();
}
}
并使用以下 JPA 转换器在模型中的ZonedDateTime
和 JDBC 中的java.util.Calendar
之间进行转换(体面的 JDBC 驱动程序将需要/使用它TIMESTAMP WITH TIME ZONE
类型列):
@Converter(autoApply=true)
public class ZonedDateTimeAttributeConverter implements AttributeConverter<ZonedDateTime, Calendar> {
@Override
public Calendar convertToDatabaseColumn(ZonedDateTime entityAttribute) {
if (entityAttribute == null) {
return null;
}
Calendar calendar = Calendar.getInstance();
calendar.setTimeInMillis(entityAttribute.toInstant().toEpochMilli());
calendar.setTimeZone(TimeZone.getTimeZone(entityAttribute.getZone()));
return calendar;
}
@Override
public ZonedDateTime convertToEntityAttribute(Calendar databaseColumn) {
if (databaseColumn == null) {
return null;
}
return ZonedDateTime.ofInstant(databaseColumn.toInstant(), databaseColumn.getTimeZone().toZoneId());
}
}
<小时 />处理 JSF 和 JPA 中的LocalDateTime
使用基于 UTC 的LocalDateTime
和适当的基于 UTC 的TIMESTAMP
(没有时区!DB 列类型中,使用以下 JSF 转换器在 UI 中的String
和模型中的LocalDateTime
之间进行转换。此转换器将从父组件中查找pattern
、timeZone
和locale
属性。如果父组件本身不支持 pattern
、 timeZone
和/或 locale
属性,只需将它们添加为 <f:attribute name="..." value="...">
即可。timeZone
属性必须表示输入字符串的回退时区(当pattern
不包含时区时)和输出字符串的时区。
@FacesConverter(forClass=LocalDateTime.class)
public class LocalDateTimeConverter implements Converter {
@Override
public String getAsString(FacesContext context, UIComponent component, Object modelValue) {
if (modelValue == null) {
return "";
}
if (modelValue instanceof LocalDateTime) {
return getFormatter(context, component).format(ZonedDateTime.of((LocalDateTime) modelValue, ZoneOffset.UTC));
} else {
throw new ConverterException(new FacesMessage(modelValue + " is not a valid LocalDateTime"));
}
}
@Override
public Object getAsObject(FacesContext context, UIComponent component, String submittedValue) {
if (submittedValue == null || submittedValue.isEmpty()) {
return null;
}
try {
return ZonedDateTime.parse(submittedValue, getFormatter(context, component)).withZoneSameInstant(ZoneOffset.UTC).toLocalDateTime();
} catch (DateTimeParseException e) {
throw new ConverterException(new FacesMessage(submittedValue + " is not a valid local date time"), e);
}
}
private DateTimeFormatter getFormatter(FacesContext context, UIComponent component) {
DateTimeFormatter formatter = DateTimeFormatter.ofPattern(getPattern(component), getLocale(context, component));
ZoneId zone = getZoneId(component);
return (zone != null) ? formatter.withZone(zone) : formatter;
}
private String getPattern(UIComponent component) {
String pattern = (String) component.getAttributes().get("pattern");
if (pattern == null) {
throw new IllegalArgumentException("pattern attribute is required");
}
return pattern;
}
private Locale getLocale(FacesContext context, UIComponent component) {
Object locale = component.getAttributes().get("locale");
return (locale instanceof Locale) ? (Locale) locale
: (locale instanceof String) ? new Locale((String) locale)
: context.getViewRoot().getLocale();
}
private ZoneId getZoneId(UIComponent component) {
Object timeZone = component.getAttributes().get("timeZone");
return (timeZone instanceof TimeZone) ? ((TimeZone) timeZone).toZoneId()
: (timeZone instanceof String) ? ZoneId.of((String) timeZone)
: null;
}
}
并使用以下 JPA 转换器在模型中的LocalDateTime
和 JDBC 中的java.sql.Timestamp
之间进行转换(体面的 JDBC 驱动程序将需要/使用它TIMESTAMP
类型列):
@Converter(autoApply=true)
public class LocalDateTimeAttributeConverter implements AttributeConverter<LocalDateTime, Timestamp> {
@Override
public Timestamp convertToDatabaseColumn(LocalDateTime entityAttribute) {
if (entityAttribute == null) {
return null;
}
return Timestamp.valueOf(entityAttribute);
}
@Override
public LocalDateTime convertToEntityAttribute(Timestamp databaseColumn) {
if (databaseColumn == null) {
return null;
}
return databaseColumn.toLocalDateTime();
}
}
<小时 />使用<p:calendar>
将LocalDateTimeConverter
应用于您的特定案例
您需要更改以下内容:
由于
<p:calendar>
不会按forClass
查找转换器,因此您需要将其重新注册到faces-config.xml
中的<converter><converter-id>localDateTimeConverter
,或者更改注释,如下所示@FacesConverter("localDateTimeConverter")
由于没有
timeOnly="true"
<p:calendar>
忽略了timeZone
,并在弹出窗口中提供了编辑它的选项,因此您需要删除timeZone
属性以避免转换器混淆(仅当pattern
中没有时区时才需要此属性)。您需要在输出期间指定所需的显示
timeZone
属性(使用ZonedDateTimeConverter
时不需要此属性,因为它已存储在ZonedDateTime
中)。
以下是完整的工作片段:
<p:calendar id="dateTime"
pattern="dd-MMM-yyyy hh:mm:ss a Z"
value="#{bean.dateTime}"
showOn="button"
required="true"
showButtonPanel="true"
navigator="true">
<f:converter converterId="localDateTimeConverter" />
</p:calendar>
<p:message for="dateTime" autoUpdate="true" />
<p:commandButton value="Submit" update="display" action="#{bean.action}" /><br/><br/>
<h:outputText id="display" value="#{bean.dateTime}">
<f:converter converterId="localDateTimeConverter" />
<f:attribute name="pattern" value="dd-MMM-yyyy hh:mm:ss a Z" />
<f:attribute name="timeZone" value="Asia/Kolkata" />
</h:outputText>
如果您打算使用属性创建自己的<my:convertLocalDateTime>
,则需要将它们作为类似 bean 的属性添加到转换器类中,并在 *.taglib.xml
中注册它,如以下答案所示: 为具有属性的转换器创建自定义标记
<h:outputText id="display" value="#{bean.dateTime}">
<my:convertLocalDateTime pattern="dd-MMM-yyyy hh:mm:ss a Z"
timeZone="Asia/Kolkata" />
</h:outputText>