CFLib.org – dateLetters

dateLetters(dateStr [, formatStr])

Last updated May 22, 2003

author

Version: 1 | Requires: ColdFusion 5 | Library: DateLib

Rated 29 time(s). Average Rating: 4.1

Description:
This will return a given date in a long formated string including the optional letters ie 1st,2nd,3rd,4th etc.

Return Values:
Returns a string.

Example:

view plain print about

<cfoutput>
#dateLetters(now())#
</cfoutput>

<cfoutput>
#dateLetters(now())#
</cfoutput>

Parameters:

Name	Description	Required
dateStr	Date to use.	Yes
formatStr	Format string for month and year.	No

Full UDF Source:

	
	
			
			
			
				
				view plain
				
				
				copy to clipboard
				
				
				
				
				print
				
				
				about
				ColdFISH is developed by Jason Delmore.  Source code and license information available at coldfish.riaforge.org.  Version 3.1.1
				
			<cfscript>
/**
 * Add's the st,nd,rd,th after a day of the month.
 * 
 * @param dateStr 	 Date to use. (Required)
 * @param formatStr 	 Format string for month and year. (Optional)
 * @return Returns a string. 
 * @author Ian Winter (&#105;&#97;&#110;&#64;&#100;&#101;&#102;&#117;&#115;&#105;&#111;&#110;&#120;&#46;&#111;&#109;) 
 * @version 1, May 22, 2003 
 */
function dateLetters(dateStr) {
	var letterList="st,nd,rd,th";
	var domStr=DateFormat(dateStr,"d");
	var domLetters='';
	var formatStr = "";

	if(arrayLen(arguments) gte 2) formatStr = dateFormat(dateStr,arguments[2]);

	switch (domStr) {
		case "1": case "21": case "31":  domLetters=ListGetAt(letterList,'1'); break;
		case "2": case "22": domLetters=ListGetAt(letterList,'2'); break;
		case "3": case "23": domLetters=ListGetAt(letterList,'3'); break;
		default: domLetters=ListGetAt(letterList,'4');
	}

	return domStr & domLetters & " " & formatStr;
}
</cfscript>
		<cfscript>
/**
 * Add's the st,nd,rd,th after a day of the month.
 * 
 * @param dateStr      Date to use. (Required)
 * @param formatStr      Format string for month and year. (Optional)
 * @return Returns a string. 
 * @author Ian Winter (ian@defusionx.om) 
 * @version 1, May 22, 2003 
 */
function dateLetters(dateStr) {
    var letterList="st,nd,rd,th";
    var domStr=DateFormat(dateStr,"d");
    var domLetters='';
    var formatStr = "";

    if(arrayLen(arguments) gte 2) formatStr = dateFormat(dateStr,arguments[2]);

    switch (domStr) {
        case "1": case "21": case "31":  domLetters=ListGetAt(letterList,'1'); break;
        case "2": case "22": domLetters=ListGetAt(letterList,'2'); break;
        case "3": case "23": domLetters=ListGetAt(letterList,'3'); break;
        default: domLetters=ListGetAt(letterList,'4');
    }

    return domStr & domLetters & " " & formatStr;
}
</cfscript>