CFLib.org – Common Function Library Project

DateTimeFormat(time[, dateFormat][, timeFormat][, joinStr])

Last updated November 26, 2001

author

Raymond Camden

Version: 1 | Requires: CF5 | Library: DateLib

Description:
This function serves as a simple shorthand for calling both DateFormat and TimeFormat on one data object.

Return Values:
This function returns a string.

Example:

<CFOUTPUT>
Default: #DateTimeFormat(Now())#<BR>
Euro Date: #DateTimeFormat(Now(),"dd/mm/yy")#<BR>
With JoinStr = at: #DateTimeFormat(Now(),"mmmm d, yyyy","h:mm tt"," at ")#<BR>
With JoinStr = /: #DateTimeFormat(Now(),"mmmm d, yyyy","h:mm tt"," / ")#
</CFOUTPUT>

Parameters:

Name Description Required
time A data object. Yes
dateFormat The string to use to format dates. Defaults to No
timeFormat The string to use to format time. Defaults to No
joinStr This string is placed between the date and time. Defaults to one space character. No

Full UDF Source:

/**
 * Calls both DateFormat and TimeFormat on a data object.
 * 
 * @param time 	 A data object. 
 * @param dateFormat 	 The string to use to format dates. Defaults to  
 * @param timeFormat 	 The string to use to format time. Defaults to  
 * @param joinStr 	 This string is placed between the date and time. Defaults to one space character. 
 * @return This function returns a string. 
 * @author Raymond Camden (ray@camdenfamily.com) 
 * @version 1, November 26, 2001 
 */
function DateTimeFormat(time) {
	var str = "";
	var dateFormat = "mmmm d, yyyy";
	var timeFormat = "h:mm tt";
	var joinStr = " ";
	
	if(ArrayLen(Arguments) gte 2) dateFormat = Arguments[2];
	if(ArrayLen(Arguments) gte 3) timeFormat = Arguments[3];
	if(ArrayLen(Arguments) gte 4) joinStr = Arguments[4];

	return DateFormat(time, dateFormat) & joinStr & TimeFormat(time, timeFormat);
}
blog comments powered by Disqus

Search CFLib.org


Latest Additions

Kevin Cotton added
date2ExcelDate
May 5, 2016

Raymond Camden added
CapFirst
April 25, 2016

Chris Wigginton added
loremIpsum
January 18, 2016

Gary Stanton added
calculateArrival...
November 19, 2015

Sebastiaan Naafs - van Dijk added
getDaysInQuarter
November 13, 2015

Created by Raymond Camden / Design by Justin Johnson