Shopping Cart

Free Newsletter
Signup

Contact

FileMaker is a registered trademark of FileMaker, Inc. in the U.S. and other countries.

FileMaker Pro Custom Functions

List | Show Random | Upload | Add This to Your Site

FormatDateTime (dateValue, timeValue, formatString)

Rate this function:

Average rating: 4.0 (6 votes)
Discuss this Custom Function

Lewis C. Lorenz, Attorney at Law
http://www.LorenzCom.com

Returns the dateValue or timeValue formatted as specified in formatString, using PHP-like coding, and allowing for escaped text.

Sample Input:

FormatDateTime ( "12/31/2011", "", "l, F j, Y" )
FormatDateTime ( "12/31/2011", "10:11:25 AM", "Ymd His" )
FormatDateTime ( "12/31/2011", "", "\today is the \dS\ day\" )

Sample Output:

Saturday, December 31, 2011
20111231 101125
today is the 31st day

Let( [d = If ( IsEmpty( dateValue ); Get ( CurrentDate ); GetAsDate ( dateValue ) ); t = If ( IsEmpty( timeValue ); Get ( CurrentTime ); GetAsTime ( timeValue ) ); format = format & If ( Mod ( PatternCount ( format; "\\" ); 2 ); "\\"; "" ); // Append \ if count not even. f = Left ( format; 1 ); f = If ( f = "\\"; Middle ( format; 1; Position ( format; "\\"; 2; 1 ) ); f ); // Escape found, set to full escaped string. c = Case( f = "\\\\"; "\\"; // If a single blackslash has been escaped, make f a single backslash. Length ( f ) > 1; Middle ( f; 2; Position ( f; "\\"; 2; 1 ) - 2); // Get the contents. Exact ( f; "d" ) ; Right ( GetAsText ( 100 + Day ( d ) ); 2 ) ; Exact ( f; "D" ) ; Left ( DayName ( d ) ; 3 ) ; Exact ( f; "j" ) ; GetAsText ( Day ( d ) ) ; Exact ( f; "l" ) ; DayName ( d ) ; Exact ( f; "N" ) ; GetAsText ( If ( DayOfWeek ( d ) - 1 = 0; 7; DayOfWeek ( d ) - 1 ) ) ; Exact ( f; "S" ) ; If ( PatternCount ( "11 12 13"; Right ( GetAsText ( 100 + Day ( d ) ); 2 ) ); "th"; Choose ( Mod ( Day ( d ) ; 10 ) ; "th"; "st"; "nd"; "rd"; "th"; "th"; "th"; "th"; "th"; "th" ) ); Exact ( f; "w" ) ; GetAsText ( DayOfWeek ( d ) ) ; Exact ( f; "z" ) ; GetAsText ( DayOfYear ( d ) ) ; Exact ( f; "W" ) ; GetAsText ( WeekOfYear ( d ) ) ; Exact ( f; "F" ) ; MonthName ( d ) ; Exact ( f; "m" ) ; Right ( GetAsText ( 100 + Month ( d ) ); 2 ) ; Exact ( f; "M" ) ; Left ( MonthName ( d ) ; 3 ) ; Exact ( f; "n" ) ; GetAsText ( Month ( d ) ) ; Exact ( f; "t" ) ; GetAsText ( Day ( Date ( Month ( d ) + 1; 1; Year ( d ) ) - 1 ) ) ; Exact ( f; "L" ) ; GetAsText ( If ( Day ( Date ( 3; 1; Year ( d ) ) - 1 ) = 29; 1; 0 ) ) ; Exact ( f; "o" ) ; GetAsText ( Year ( d ) + Case ( WeekOfYear ( d ) = 1 and DayOfWeek ( Date ( 1; 1; Year ( d ) ) ) > 1; -1; WeekOfYear ( d ) > 52 and DayOfWeek ( Date ( 12; 31; Year ( d ) ) ) < 7 ; 1 ; 0 ) ) ; Exact ( f; "Y" ) ; GetAsText ( Year ( d ) ) ; Exact ( f; "y" ) ; Right ( GetAsText ( Year ( d ) ) ; 2 ) ; Exact ( f; "a" ) ; If ( GetAsNumber ( t ) > 43200; "pm"; "am" ) ; Exact ( f; "A" ) ; If ( GetAsNumber ( t ) > 43200; "PM"; "AM" ) ; Exact ( f; "g" ) ; GetAsText ( If ( Hour ( t ) > 12; Hour ( t ) - 12; Hour ( t ) ) ) ; Exact ( f; "G" ) ; GetAsText ( Hour ( t ) ) ; Exact ( f; "h" ) ; Right ( GetAsText ( 100 + If ( Hour ( t ) > 12; Hour ( t ) - 12; Hour ( t ) ) ); 2) ; Exact ( f; "H" ) ; Right ( GetAsText ( 100 + Hour ( t ) ); 2 ); Exact ( f; "i" ) ; Right ( GetAsText ( 100 + Minute ( t ) ); 2); Exact ( f; "s" ) ; Right ( GetAsText ( 100 + Seconds ( t ) ); 2); Exact ( f; "u" ) ; GetAsText ( GetAsNumber ( t ) ) ; f); // Prepare for recursive call. format = Right ( format; Length (format ) - Length ( f ) ); // Call if not empty. c = c & If ( IsEmpty ( format ); ""; FormatDateTime ( d; t; format ) )]; c ) /* FormatDateTime ( dateValue, timeValue, format ) by Lewis C. Lorenz 9-22-2011 Created 11-29-2011 Modified 12-4-11 Modified Returns the dateValue or timeValue formatted as specified in format. If dateValue or timeValue are empty current date or current time are used. Optionally use the backslash as an escape code to include text not intended to be formatted. Escaped \ is written \\, all other escaped text must be enclosed within an opening \ and a closing \. Formatting performed using PHP date() function format codes but with Filemaker conventions. Day ------- d - 01-31 D - Mon-Sun j - 1-31 l (lowercase 'L') - Sunday-Saturday N - 1 (Monday) ... 7 (Sunday). (PHP convention: ISO-8601 representation of day of week.) S - st, nd, rd or th (English ordinal suffix.) w - 1 (Sunday) ... 7 (Saturday). (PHP convention : 0 (for Sunday) through 6 (for Saturday).) z - 1-366. (PHP convention: 0-365.) Week ----- W - 1-54, week of year Jan. 1. (PHP convention: ISO-8601 week number of year, weeks starting on Monday.) Month ---- F - January-December m - 01-12 M - Jan-Dec n - 1-12 t - 28-31 Year ----- L - Leap year (1/0) o - year number. ISO-8601 year number. Y - 4 digit year y - 2 digit year Time ---- a - am/pm A - AM/PM g - Hour 1-12 G - Hour 0-23 h - Hour 01-12 H - Hour 00-23 i - Min 00-59 s - Sec 00-59 u - Microseconds Examples: FormatDateTime ( 9/21/2005, 11:06:53, "Y-m-d His \zulu\") = 2005-09-21 110653 zulu FormatDateTime ( 10-31-2011, "", "\today is the \dS\ day\") = today is the 31st day */
Then copy & paste into FileMaker Advanced's Edit Custom Function window.

Click here to copy To Clip Manager if you have myFMbutler's Clip Manager installed

Description:

FormatDateTime ( dateValue, timeValue, formatString )

by Lewis C. Lorenz

9-22-2011 Created
11-29-2011 Modified
12-4-11 Modified

Returns the dateValue or timeValue formatted as specified in formatString.
If dateValue or timeValue are empty current date or current time are used.
Optionally use the backslash as an escape code to include text not intended to be formatted.
Escaped \ is written \\, all other escaped text must be enclosed within an opening \ and a closing \.
Formatting performed using PHP date() function format codes but with Filemaker conventions.
Day -------
d - 01-31
D - Mon-Sun
j - 1-31
l (lowercase 'L') - Sunday-Saturday
N - 1 (Monday) ... 7 (Sunday). (PHP convention: ISO-8601 representation of day of week.)
S - st, nd, rd or th (English ordinal suffix.)
w - 1 (Sunday) ... 7 (Saturday). (PHP convention : 0 (for Sunday) through 6 (for Saturday).)
z - 1-366. (PHP convention: 0-365.)
Week -----
W - 1-54, week of year Jan. 1. (PHP convention: ISO-8601 week number of year, weeks starting on Monday.)
Month ----
F - January-December
m - 01-12
M - Jan-Dec
n - 1-12
t - 28-31
Year -----
L - Leap year (1/0)
o - year number. ISO-8601 year number.
Y - 4 digit year
y - 2 digit year
Time ----
a - am/pm
A - AM/PM
g - Hour 1-12
G - Hour 0-23
h - Hour 01-12
H - Hour 00-23
i - Min 00-59
s - Sec 00-59
u - Microseconds

Note: these functions are not guaranteed or supported by BrianDunning.com. Please contact the individual developer with any questions or problems.

This is my Custom Function and I want to edit it

Discuss:

There are no comments yet. Be the first to post a comment about this Custom Function! Please try to keep it brief & to the point. Anyone can post:

Download the Custom Function Dashboard Widget for OS X
Keep all the latest Custom Functions right at your fingertips!

Newest Custom Functions:

1.	ListToggle ( InList ; InValue )
	(Thu, May 16, 6:59pm)
2.	VatFormat ( vat )
	(Tue, May 14, 2:45am)
3.	CheckVatBE ( vat )
	(Tue, May 14, 2:32am)
4.	CheckIBAN (IBAN )
	(Tue, May 14, 2:24am)
5.	OrcidCheckDigit ( Orcid_id ; Result ; Iterations )
	(Wed, May 08, 1:44am)
6.	DateRangeBySpan ( Begin ; End ; Term)
	(Mon, May 06, 6:53am)
7.	Convert_Arabic_to_Chinese( number )
	(Thu, May 02, 6:10am)
8.	NPVV ( cashFlowList, interestRate )
	(Sun, Apr 28, 1:56pm)


			[ Close Window ]
	The class that teaches you how to successfully sell your FileMaker Pro solution as a professional shrinkwrapped software application.
	Let's Meet in Person Sunday, August 13 2006, Orlando FL Courtyard Orlando International Drive
	Don't miss this most important day of the Developer Conference. Please click here for complete details and online registration.

FileMaker Pro Custom Functions

Description:

Discuss:

Let's Meet in Person