JSF <f:convertDateTime> 标签

2024 年 8 月 29 日 | 阅读 3 分钟

它用于将用户输入转换为指定的日期。您可以通过将 convertDateTime 标签嵌套在组件标签内，将组件的数据转换为 java.util.Date。 convertDateTime 标签有几个属性，允许您指定数据的格式和类型。

标签属性

属性	类型	描述
binding	DateTimeConverter	它用于将转换器绑定到托管 bean 属性。
dateStyle	String	它用于定义日期或日期字符串的日期部分的格式，如 java.text.DateFormat 所指定。仅当 type 为 date 或 both 且未定义 pattern 时应用。有效值：default、short、medium、long 和 full。如果未指定值，则使用 default。
for	String	它用于引用复合组件内部的某个对象，该标签嵌套在复合组件中。
locale	String 或 Locale	它是 Locale 的一个实例，其用于格式化或解析的日期和时间具有预定义的样式。如果未指定，将使用 FacesContext.getLocale 返回的 Locale。
pattern	String	它用于自定义格式化模式，该模式确定日期/时间字符串的格式化和解析方式。如果指定了此属性，则会忽略 dateStyle、timeStyle 和 type 属性。
timeStyle	String	它用于定义时间或日期字符串的时间部分的格式，如 java.text.DateFormat 所指定。仅当 type 为 time 且未定义 pattern 时应用。有效值：default、short、medium、long 和 full。如果未指定值，则使用 default。
timeZone	String 或 TimeZone	它用于解释日期字符串中的任何时间信息时所使用的时区。
type	String	它用于指定字符串值是否包含日期、时间或两者。有效值是 date、time 或 both。如果未指定值，则使用 date。

JSF <f:converterDateTime> 标签示例 1

// index.xhtml

<h:form>
<h:outputLabel for="username">User Name</h:outputLabel>
<h:inputText id="user-id" value="#{user.name}"/><br/>
<h:outputLabel for="age">Date of Birth</h:outputLabel>
<h:inputText id="dob-id" value="#{user.dob}" converterMessage="Please provide date of birth in dd/mm/yyyy format">
<f:convertDateTime pattern="dd/mm/yyyy" />
</h:inputText><br/>
<h:commandButton action="response.xhtml" value="Submit"/>
</h:form>

// User.java

import java.util.Date;
import javax.faces.bean.ManagedBean;
import javax.faces.bean.RequestScoped;
@ManagedBean
@RequestScoped
public class User {
String name;
Date dob;
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public Date getDob() {
return dob;
}
public void setDob(Date dob) {
this.dob = dob;
}
}

// response.xhtml

<h:body>
<h1> Hello, 
<h:outputText value="#{user.name}"/>
</h1>
<h:outputLabel>Your date of birth is: </h:outputLabel>
<h:outputText value="#{user.dob}">
<f:convertDateTime pattern="dd/mm/yyyy"/>
</h:outputText>
</h:body>

输出

// 首页

// 首页

// 响应页面

JSF <f:converterDateTime> 标签示例 2

// index.xhtml

<h:form>
<h:outputLabel for="username">User Name</h:outputLabel>
<h:inputText id="user-id" value="#{user.name}"/><br/>
<h:outputLabel for="age">Date of Birth</h:outputLabel>
<h:inputText id="dob-id" value="#{user.dob}">
<f:convertDateTime pattern="dd/MM/yyyy"/>
</h:inputText>
<br/>
<h:commandButton action="response.xhtml" value="Submit"/>
</h:form>

// User.Java

import java.util.Date;
import javax.faces.bean.ManagedBean;
import javax.faces.bean.RequestScoped;
@ManagedBean
@RequestScoped
public class User {
String name;
Date dob;
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public Date getDob() {
return dob;
}
public void setDob(Date dob) {
this.dob = dob;
}
}

// response.xhtml

<?xml version='1.0' encoding='UTF-8' ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN""http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"
xmlns:h="http://xmlns.jcp.org/jsf/html"
xmlns:f="http://java.sun.com/jsf/core">

<h:head>
<title>Response Page</title>
</h:head>
<h:body>
<h1> Hello, 
<h:outputText value="#{user.name}"/>
</h1>
<h:outputLabel value="Your date of birth in different-different formats is given below:"></h:outputLabel><br/>
<h:outputText value="#{user.dob}">
<f:convertDateTime type="date" dateStyle="medium"/>
</h:outputText>
<br/>
<h:outputText value="#{user.dob}">
<f:convertDateTime type="date" dateStyle="full"/>
</h:outputText>
<br/>
<h:outputText value="#{user.dob}">
<f:convertDateTime type="time" dateStyle="full"/>
</h:outputText>
<br/>
<h:outputText value="#{user.dob}">
<f:convertDateTime type="date" pattern="dd/mm/yyyy"/>
</h:outputText>
<br/>
<h:outputText value="#{user.dob}">
<f:convertDateTime dateStyle="full" pattern="yyyy-mm-dd"/>
</h:outputText>
<br/>
<h:outputText value="#{user.dob}">
<f:convertDateTime dateStyle="full" pattern="yyyy.MM.dd 'at' HH:mm:ss z"/>
</h:outputText>
<br/>
<h:outputText value="#{user.dob}">
<f:convertDateTime dateStyle="full" pattern="h:mm a"/>
</h:outputText>
<br/>
<h:outputText value="#{user.dob}">
<f:convertDateTime dateStyle="long" timeZone="EST" type="both"/>
</h:outputText>
<br/>
<h:outputText value="#{user.dob}">
<f:convertDateTime locale="de" timeStyle="long" type="both" dateStyle="full"/>
</h:outputText>
<br/>
<h:outputText value="#{user.dob}">
<f:convertDateTime locale="en" timeStyle="short" type="both" dateStyle="full"/>
</h:outputText>
</h:body>
</html>

输出

// 首页