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

fnNumberFormat ( number ; decimals ; dec_point ; thousands_sep )

Rate this function:

Average rating: 3.1 (25 votes)
Discuss this Custom Function

Andrew Butt, Drewsol
http://www.drewsol.com

This CF simply emulates PHP's number_format() function using identical parameters (http://us2.php.net/number_format).

Sample Input:

fnNumberFormat ( 12345678.9012 ; 2 ; "." ; "," )

Sample Output:

12,345,678.90

/* fnNumberFormat v1.4 Copyright © 2009 Drewsol GNU Lesser General Public License: This function is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this program. If not, see <http://www.gnu.org/licenses/>. This CF simply emulates PHP's number_format() function using identical parameters (http://us2.php.net/number_format). Parameters: - number - decimals - dec_point - thousands_sep ChangeLog: v1.4 - Removes decimal point if there are no decimal places (suggestion by Matthias Wuttke, Eschlikon TG) and allows for negative decimal places. v1.3 - Permits a no-parameter option to return same number as entered. v1.2 - Bug fixes. v1.1 - Bug fixes. v1.0 - Initial release. */ Let ( [ pos_decimal = Case ( PatternCount ( number ; "." ) > 0 ; Position ( number ; "." ; 1 ; 1 ) ; Length ( number ) + 1 ) ; decimal_places = Length ( number ) - pos_decimal ; dollars_v1 = Case ( not ( decimals < 0 ) ; Left ( number ; pos_decimal - 1 ) ; Round ( Left ( number ; pos_decimal - 1 ) ; decimals ) ) ; dollars_v2 = Case ( dollars_v1 = "" ; "0" ; dollars_v1 ) ; dollars = Substitute ( NumToJText ( dollars_v2 ; 1 ; 0 ) ; [ "," ; thousands_sep ] ) ; cents_v1 = Right ( number ; decimal_places ) ; cents = Case ( decimals > Length ( cents_v1 ) ; Let ( [ n = decimals - Length ( cents_v1 ) - 1 ; zeros = Substitute ( 10^n ; [ 1 ; 0 ] ) ] ; cents_v1 & zeros ) ; decimals < Length ( cents_v1 ) ; Case ( Length ( Substitute ( Round ( "." & cents_v1 ; decimals ) ; [ "." ; "" ] ) ) = decimals ; Substitute ( Round ( "." & cents_v1 ; decimals ) ; [ "." ; "" ] ) ; Length ( Substitute ( Round ( "." & cents_v1 ; decimals ) ; [ "." ; "" ] ) ) < decimals ; Let ( [ n = decimals ; zeros = Substitute ( 10^n ; [ 1 ; 0 ] ) ] ; Substitute ( Round ( "." & cents_v1 ; decimals ) ; [ "." ; "" ] ) & Left ( zeros ; decimals - 1 ) ) ) ; cents_v1 ) ] ; Case ( // No parameters specified... decimals = "" and dec_point = "" and thousands_sep = "" ; number ; // No decimal requested (courtesy of Matthias Wuttke, Eschlikon TG) decimals = 0 or decimals = "" or decimals < 0 ; dollars ; // Else dollars & dec_point & cents ) )
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:

This CF simply emulates PHP's number_format() function using identical parameters (http://us2.php.net/number_format).

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:

5 most recent comments | Show all 6 comments

Hi Bruce,

Quite honestly, I paste this tag on all of my created CFs. Seeing that the phrase has become obsolete as of 2000, I'm removing it. However, these 'reserved rights' are what allow us to freely distribute our CFs in the first place! :)

Drew Wesley, Los Angeles, CA
May 09, 2009 12:03am

Hi all

I have a small add to this Function:
If I choose 0 Decimals, then I don't like for Example 35'000.
I would like to have 35'000
without a Point on the End....
Here the Solution: (only the last couple Lines
-------------------------------------------------------------------- ------
.
Case (
// No parameters specified...
decimals = "" AND dec_point = "" AND thousands_sep = "" ;
number ;
// No decimal requested
decimals = 0;
dollars;
// Else
dollars & dec_point & cents
)
)
--------------------------------------------------------------------- -----
Anyhow Bruce Thanks for this great Function!

Matthias Wuttke, Eschlikon TG
October 14, 2009 2:46am

Hi Matthias,

I implemented your good suggestion and made another improvement to include negative decimals - similar to the way the Round ( ) function works.

Drew Wesley, Los Angeles, CA
October 16, 2009 10:10am

Hi,

This doesn't work with non english langauges, at least those whose native decimal separateor are not .

Your code assumes that the number have their decimal separator as a dot. If you use Filemaker on a french OS, then FMP internal decimal separator wil be the comma.

So you have to avoid this assumption in your code.

Moreover an option to avoir 129,00 when the nulber is just 129 would be nice

Thanks

Vincent, France
February 11, 2011 2:51am

Just a warning not to use this function with numbers containing leading zeros (typically stored as a text field). This function will strip leading zeros from those numbers.

Jon Rosen, Pembroke Pines, FL
January 24, 2012 2:27pm

Make 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.	indonesian_date(date)
	(Mon, Feb 06, 7:14pm)
2.	phpArrayValue ( array ; key ; pos )
	(Fri, Jan 27, 1:49pm)
3.	solfm_timeToMinutes (theTime;roundSec)
	(Fri, Jan 20, 6:26am)
4.	filterLines(filterField;filterValue;Result)
	(Sat, Jan 14, 2:20pm)
5.	getMaxValue ( theList )
	(Thu, Jan 12, 1:06pm)
6.	MiddleWordsIncPunct ( text ; startingWord ; numberOfWords )
	(Sat, Jan 07, 9:16am)
7.	WindowInfo
	(Fri, Jan 06, 12:39pm)
8.	CenterWindow in Window vert horiz (demension)
	(Fri, Jan 06, 12:25pm)


			[ 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