Home >	Contents >	Index >

Template Tags TOC   |    Alpha TOC   |    Tag Family TOC   |    Purpose TOC   |    Annotated TOC   |    Index

dateformat:create

Creates a date-format object which can be used to convert a date value to a displayable string.

Syntax

<dateformat:create
      name="objectName" 
      [locale="localeObjectName"]
      [datestyle="medium|short|long|full"]
      [timestyle="medium|short|long|full"]
      [timezoneid="timeZoneID"]/>

Parameters

name (required)

Input. Name to assign the date-format object.

locale (optional)

Name of the locale object to use for this date-format object. If not specified, the default is the current machine default locale.

datestyle (optional)

Style for date. Default is MEDIUM. The possible values are as follows:

• short - Completely numeric, such as 12.13.52.
• medium - (Default) Longer, such as Jan. 12, 1952.
• long - Still longer, such as January 12, 1952.
• full - Fully specified, such as Tuesday, April 12, 1952 AD.

timestyle (optional)

Style for time. Default is MEDIUM. The legal values are as follows:

• medium - (Default) Completely numeric, such as 3:30:42pm.
• full - Fully specified, such as 3:30:42pm PST. The timezone will only be appended if it is specified by the timezoneid attribute.

TIMEZONEID (optional)

TimeZoneID for the DateFormat object. See TimeZoneID Numbers for a list of ID numbers.

Description

This tag creates a date-format object which can be used for formatting a date for display in a specified locale.

errno

None.

Example

This displays a date with the information Jan 12, 1952 ;3:30:42pm in the locale of the current user.

<locale.create varname="localename" localename='<%=ics.getssvar("locale")%>' />
<dateformat:create name="_formatdate_" timestyle="full" locale="localename"/>
<dateformat:getdatetime name="_formatdate_" value='<%=ics.getvar("inputdate")%>' valuetype="jdbcdate" varname="formatteddate"/>
<ics:getvar("formatteddate")>

See Also

dateformat:getdate
dateformat:gettime
dateformat:getdatetime
locale:create

		Home >	Contents >	Index >
	FatWire JSP Tag Reference Copyright 2005,2006,2007 by FatWire Software All rights reserved.