Calculated Field Formulas

Applies to: SharePoint Foundation 2010

The following tables provide information about the various kinds of formulas you can implement in a calculated field by using the Formula of the Microsoft.SharePoint.SPFieldCalculated class.

Important Notes

Note

Microsoft SharePoint Foundation formulas for calculated fields are based on Microsoft Excel functions and syntax. However, Microsoft supports only those functions mentioned on this page for use in SharePoint Foundation calculated fields. For example, the Excel function MID is not supported.

Important

All example formulas in this topic use commas "," as the parameter delimiter character. In some countries, the comma is reserved for use as the decimal mark. In such countries, users creating a calculated field must use semi-colons ";" as the delimiter character. Regardless of which character is used when the field is created, the formula works on lists in SharePoint websites anywhere in the world. SharePoint automatically changes the delimiter character to the one that is appropriate for the language/culture of the current page. For example, suppose the following formula is created on a website whose culture setting is fr-fr (France): =IF(Number1>Number2;5;10). If the website's culture is then changed to en-us (United States), the formula changes automatically to: =IF(Number1>Number2,5,10).

Conditional formulas

You can use the following formulas to test the condition of a statement and return a Yes or No value, to test an alternate value such as OK or Not OK, or to return a blank or dash to represent a null value.

Determine whether a number is greater than or less than another number

Use the IF function to perform this comparison.

Column1

Column2

Formula

Description (possible result)

15000

9000

=[Column1]>[Column2]

Is Column1 greater than Column2? (Yes)

15000

9000

=IF([Column1]<=[Column2], "OK", "Not OK")

Is Column1 less than or equal to Column2? (Not OK)

Return a logical value after comparing column contents

For a result that is a logical value (Yes or No), use the AND, OR, and NOT functions.

Column1

Column2

Column3

Formula

Description (possible result)

15

9

8

=AND([Column1]>[Column2], [Column1]<[Column3])

Is 15 greater than 9 and less than 8? (No)

15

9

8

=OR([Column1]>[Column2], [Column1]<[Column3])

Is 15 greater than 9 or less than 8? (Yes)

15

9

8

=NOT([Column1]+[Column2]=24)

Is 15 plus 9 not equal to 24? (No)

For a result that is another calculation, or any other value other than Yes or No, use the IF, AND, and OR functions.

Column1

Column2

Column3

Formula

Description (possible result)

15

9

8

=IF([Column1]=15, "OK", "Not OK")

If the value in Column1 equals 15, return "OK". (OK)

15

9

8

=IF(AND([Column1]>[Column2], [Column1]<[Column3]), "OK", "Not OK")

If 15 is greater than 9 and less than 8, return "OK". (Not OK)

15

9

8

=IF(OR([Column1]>[Column2], [Column1]<[Column3]), "OK", "Not OK")

If 15 is greater than 9 or less than 8, return "OK". (OK)

Display zeroes as blanks or dashes

To display a zero, perform a simple calculation. To display a blank or a dash, use the IF function.

Column1

Column2

Formula

Description (possible result)

10

10

=[Column1]-[Column2]

Second number subtracted from the first. (0)

15

9

=IF([Column1]-[Column2],[Column1]-[Column2],"-")

Returns a dash when the value is zero. (-)

Hide error values in columns

To display a dash, #N/A, or NA in place of an error value, use the ISERROR function.

Column1

Column2

Formula

Description (possible result)

10

0

=[Column1]/[Column2]

Results in an error (#DIV/0)

10

0

=IF(ISERROR([Column1]/[Column2]),"NA",[Column1]/[Column2])

Returns NA when the value is an error

10

0

=IF(ISERROR([Column1]/[Column2]),"-",[Column1]/[Column2])

Returns a dash when the value is an error

Date and time formulas

You can use the following formulas to perform calculations that are based on dates and times, such as adding a number of days, months, or years to a date, calculating the difference between two dates, and converting time to a decimal value.

Add dates

To add a number of days to a date, use the addition (+) operator.

Note

When you manipulate dates, the return type of the calculated column must be set to Date and Time.

Column1

Column2

Formula

Description (possible result)

6/9/2007

3

=[Column1]+[Column2]

Adds 3 days to 6/9/2007 (6/12/2007)

12/10/2008

54

=[Column1]+[Column2]

Adds 54 days to 12/10/2008 (2/2/2009)

To add a number of months to a date, use the DATE, YEAR, MONTH, and DAY functions.

Column1

Column2

Formula

Description (possible result)

6/9/2007

3

=DATE(YEAR([Column1]),MONTH([Column1])+[Column2],DAY([Column1]))

Adds 3 months to 6/9/2007 (9/9/2007)

12/10/2008

25

=DATE(YEAR([Column1]),MONTH([Column1])+[Column2],DAY([Column1]))

Adds 25 months to 12/10/2008 (1/10/2011)

To add a number of years to a date, use the DATE, YEAR, MONTH, and DAY functions.

Column1

Column2

Formula

Description (possible result)

6/9/2007

3

=DATE(YEAR([Column1])+[Column2],MONTH([Column1]),DAY([Column1]))

Adds 3 years to 6/9/2007 (6/9/2010)

12/10/2008

25

=DATE(YEAR([Column1])+[Column2],MONTH([Column1]),DAY([Column1]))

Adds 25 years to 12/10/2008 (12/10/2033)

To add a combination of days, months, and years to a date, use the DATE, YEAR, MONTH, and DAY functions.

Column1

Formula

Description (possible result)

6/9/2007

=DATE(YEAR([Column1])+3,MONTH([Column1])+1,DAY([Column1])+5)

Adds 3 years, 1 month, and 5 days to 6/9/2007 (7/14/2010)

12/10/2008

=DATE(YEAR([Column1])+1,MONTH([Column1])+7,DAY([Column1])+5)

Adds 1 year, 7 months, and 5 days to 12/10/2008 (7/15/2010)

Calculate the difference between two dates

Use the DATEDIF function to perform this calculation.

Column1

Column2

Formula

Description (possible result)

01-Jan-1995

15-Jun-1999

=DATEDIF([Column1], [Column2],"d")

Returns the number of days between the two dates (1626)

01-Jan-1995

15-Jun-1999

=DATEDIF([Column1], [Column2],"ym")

Returns the number of months between the dates, ignoring the year part (5)

01-Jan-1995

15-Jun-1999

=DATEDIF([Column1], [Column2],"yd")

Returns the number of days between the dates, ignoring the year part (165)

Calculate the difference between two times

To present the result in the standard time format (hours:minutes:seconds), use the subtraction operator (-) and the TEXT function. For this method to work, hours must not exceed 24, and minutes and seconds must not exceed 60.

Column1

Column2

Formula

Description (possible result)

06/09/2007 10:35 AM

06/09/2007 3:30 PM

=TEXT([Column2]-[Column1],"h")

Hours between two times (4)

06/09/2007 10:35 AM

06/09/2007 3:30 PM

=TEXT([Column2]-[Column1],"h:mm")

Hours and minutes between two times (4:55)

06/09/2007 10:35 AM

06/09/2007 3:30 PM

=TEXT([Column2]-[Column1],"h:mm:ss")

Hours, minutes, and seconds between two times (4:55:00)

To present the result in a total that is based on one time unit, use the INT function, or HOUR, MINUTE, or SECOND function.

Column1

Column2

Formula

Description (possible result)

06/09/2007 10:35 AM

06/10/2007 3:30 PM

=INT(([Column2]-[Column1])*24)

Total hours between two times (28)

06/09/2007 10:35 AM

06/10/2007 3:30 PM

=INT(([Column2]-[Column1])*1440)

Total minutes between two times (1735)

06/09/2007 10:35 AM

06/10/2007 3:30 PM

=INT(([Column2]-[Column1])*86400)

Total seconds between two times (104100)

06/09/2007 10:35 AM

06/10/2007 3:30 PM

=HOUR([Column2]-[Column1])

Hours between two times, when the difference does not exceed 24 (4)

06/09/2007 10:35 AM

06/10/2007 3:30 PM

=MINUTE([Column2]-[Column1])

Minutes between two times, when the difference does not exceed 60 (55)

06/09/2007 10:35 AM

06/10/2007 3:30 PM

=SECOND([Column2]-[Column1])

Seconds between two times, when the difference does not exceed 60 (0)

Convert times

To convert hours from the standard time format to a decimal number, use the INT function.

Column1

Formula

Description (possible result)

10:35 AM

=([Column1]-INT([Column1]))*24

Number of hours since 12:00 AM (10.583333)

12:15 PM

=([Column1]-INT([Column1]))*24

Number of hours since 12:00 AM (12.25)

To convert hours from a decimal number to the standard time format (hours:minutes:seconds), use the division operator and the TEXT function.

Column1

Formula

Description (possible result)

23:58

=TEXT(Column1/24, "hh:mm:ss")

Hours, minutes, and seconds since 12:00 AM (00:59:55)

2:06

=TEXT(Column1/24, "h:mm")

Hours and minutes since 12:00 AM (0:05)

Insert Julian dates

A Julian date refers to a date format that is a combination of the current year and the number of days since the beginning of the year. For example, January 1, 2007, is represented as 2007001 and December 31, 2007, is represented as 2007365. This format is not based on the Julian calendar.

To convert a date to a Julian date, use the TEXT and DATEVALUE functions.

Column1

Formula

Description (possible result)

6/23/2007

=TEXT([Column1],"yy")&TEXT(([Column1]-DATEVALUE("1/1/"& TEXT([Column1],"yy"))+1),"000")

Date in Julian format, with a two-digit year (07174)

6/23/2007

=TEXT([Column1],"yyyy")&TEXT(([Column1]-DATEVALUE("1/1/"&TEXT([Column1],"yy"))+1),"000")

Date in Julian format, with a four-digit year (2007174)

To convert a date to a Julian date that is used in astronomy, use the constant 2415018.50. This formula works only for dates after 3/1/1901, and if you are using the 1900 date system.

Column1

Formula

Description (possible result)

6/23/2007

=[Column1]+2415018.50

Date in Julian format, used in astronomy (2454274.50)

Show dates as the day of the week

To convert dates to the text for the day of the week, use the TEXT and WEEKDAY functions.

Column1

Formula

Description (possible result)

19-Feb-2007

=TEXT(WEEKDAY([Column1]), "dddd")

Calculates the day of the week for the date and returns the full name of the day (Monday)

3-Jan-2008

=TEXT(WEEKDAY([Column1]), "ddd")

Calculates the day of the week for the date and returns the abbreviated name of the day (Thu)

Mathematical formulas

You can use the following formulas to perform a variety of mathematical calculations, such as adding, subtracting, multiplying, and dividing numbers; calculating the average or median of numbers; rounding a number; and counting values.

Add numbers

To add numbers in two or more columns in a row, use the addition operator (+) or the SUM function.

Column1

Column2

Column3

Formula

Description (possible result)

6

5

4

=[Column1]+[Column2]+[Column3]

Adds the values in the first three columns (15)

6

5

4

=SUM([Column1],[Column2],[Column3])

Adds the values in the first three columns (15)

6

5

4

=SUM(IF([Column1]>[Column2], [Column1]-[Column2], 10), [Column3])

If Column1 is greater than Column2, adds the difference and Column3. Else add 10 and Column3 (5)

Subtract numbers

To subtract numbers in two or more columns in a row, use the subtraction operator (-) or the SUM function with negative numbers.

Column1

Column2

Column3

Formula

Description (possible result)

15000

9000

-8000

=[Column1]-[Column2]

Subtracts 9000 from 15000 (6000)

15000

9000

-8000

=SUM([Column1], [Column2], [Column3])

Adds numbers in the first three columns, including negative values (16000)

Calculate the difference between two numbers as a percentage

Use the subtraction (-) and division (/) operators and the ABS function.

Column1

Column2

Formula

Description (possible result)

2342

2500

=([Column2]-[Column1])/ABS([Column1])

Percentage change (6.75% or 0.06746)

Multiply numbers

To multiply numbers in two or more columns in a row, use the multiplication operator (*) or the PRODUCT function.

Column1

Column2

Formula

Description (possible result)

5

2

=[Column1]*[Column2]

Multiplies the numbers in the first two columns (10)

5

2

=PRODUCT([Column1], [Column2])

Multiplies the numbers in the first two columns (10)

5

2

=PRODUCT([Column1],[Column2],2)

Multiplies the numbers in the first two columns and the number 2 (20)

Divide numbers

To divide numbers in two or more columns in a row, use the division operator (/).

Column1

Column2

Formula

Description (possible result)

15000

12

=[Column1]/[Column2]

Divides 15000 by 12 (1250)

15000

12

=([Column1]+10000)/[Column2]

Adds 15000 and 10000, and then divides the total by 12 (2083)

Calculate the average of numbers

The average is also called the mean. To calculate the average of numbers in two or more columns in a row, use the AVERAGE function.

Column1

Column2

Column3

Formula

Description (possible result)

6

5

4

=AVERAGE([Column1], [Column2],[Column3])

Average of the numbers in the first three columns (5)

6

5

4

=AVERAGE(IF([Column1]>[Column2], [Column1]-[Column2], 10), [Column3])

If Column1 is greater than Column2, calculate the average of the difference and Column3. Else calculate the average of the value 10 and Column3 (2.5)

Calculate the median of numbers

The median is the value at the center of an ordered range of numbers. Use the MEDIAN function to calculate the median of a group of numbers.

A

B

C

D

E

F

Formula

Description (result)

10

7

9

27

0

4

=MEDIAN(A, B, C, D, E, F)

Median of numbers in the first 6 columns (8)

Calculate the smallest or largest number in a range

To calculate the smallest or largest number in two or more columns in a row, use the MIN and MAX functions.

Column1

Column2

Column3

Formula

Description (possible result)

10

7

9

=MIN([Column1], [Column2], [Column3])

Smallest number (7)

10

7

9

=MAX([Column1], [Column2], [Column3])

Largest number (10)

Count values

To count numeric values, use the COUNT function.

Column1

Column2

Column3

Formula

Description (possible result)

Apple

12/12/2007

=COUNT([Column1], [Column2], [Column3])

Counts the number of columns that contain numeric values. Excludes date and time, text, and null values (0)

$12

#DIV/0!

1.01

=COUNT([Column1], [Column2], [Column3])

Counts the number of columns that contain numeric values, but excludes error and logical values (2)

Increase or decrease a number by a percentage

Use the percent (%) operator to perform this calculation.

Column1

Column2

Formula

Description (possible result)

23

3%

=[Column1]*(1+5%)

Increases number in Column1 by 5% (24.15)

23

3%

=[Column1]*(1+[Column2])

Increases number in Column1 by the percent value in Column2: 3% (23.69)

23

3%

=[Column1]*(1-[Column2])

Decreases number in Column1 by the percent value in Column2: 3% (22.31)

Raise a number to a power

Use the exponentiation operator (^) or the POWER function to perform this calculation.

Column1

Column2

Formula

Description (possible result)

5

2

=[Column1]^[Column2]

Calculates five squared (25)

5

3

=POWER([Column1], [Column2])

Calculates five cubed (125)

Round a number

To round up a number, use the ROUNDUP, ODD, or EVEN function.

Column1

Formula

Description (possible result)

20.3

=ROUNDUP([Column1],0)

Rounds 20.3 up to the nearest whole number (21)

-5.9

=ROUNDUP([Column1],0)

Rounds -5.9 up to the nearest whole number (-5)

12.5493

=ROUNDUP([Column1],2)

Rounds 12.5493 up to the nearest hundredth, two decimal places (12.55)

20.3

=EVEN([Column1])

Rounds 20.3 up to the nearest even number (22)

20.3

=ODD([Column1])

Rounds 20.3 up to the nearest odd number (21)

To round down a number, use the ROUNDDOWN function.

Column1

Formula

Description (possible result)

20.3

=ROUNDDOWN([Column1],0)

Rounds 20.3 down to the nearest whole number (20)

-5.9

=ROUNDDOWN([Column1],0)

Rounds -5.9 down to the nearest whole number (-6)

12.5493

=ROUNDDOWN([Column1],2)

Rounds 12.5493 down to the nearest hundredth, two decimal places (12.54)

To round a number to the nearest number or fraction, use the ROUND function.

Column1

Formula

Description (possible result)

20.3

=ROUND([Column1],0)

Rounds 20.3 down, because the fractional part is less than .5 (20)

5.9

=ROUND([Column1],0)

Rounds 5.9 up, because the fractional part is greater than .5 (6)

-5.9

=ROUND([Column1],0)

Rounds -5.9 down, because the fractional part is less than -.5 (-6)

1.25

=ROUND([Column1], 1)

Rounds the number to the nearest tenth (one decimal place). Because the portion to be rounded is 0.05 or greater, the number is rounded up (result: 1.3)

30.452

=ROUND([Column1], 2)

Rounds the number to the nearest hundredth (two decimal places). Because the portion to be rounded, 0.002, is less than 0.005, the number is rounded down (result: 30.45)

To round a number to the significant digit above 0, use the ROUND, ROUNDUP, ROUNDDOWN, INT, and LEN functions.

Column1

Formula

Description (possible result)

5492820

=ROUND([Column1],3-LEN(INT([Column1])))

Rounds the number to 3 significant digits (5490000)

22230

=ROUNDDOWN([Column1],3-LEN(INT([Column1])))

Rounds the bottom number down to 3 significant digits (22200)

5492820

=ROUNDUP([Column1], 5-LEN(INT([Column1])))

Rounds the top number up to 5 significant digits (5492900)

Text formulas

You can use the following formulas to manipulate text, such as combining or concatenating the values from multiple columns, comparing the contents of columns, removing characters or spaces, and repeating characters.

Change the case of text

To change the case of text, use the UPPER, LOWER, or PROPER function.

Column1

Formula

Description (possible result)

nina Vietzen

=UPPER([Column1])

Changes text to uppercase (NINA VIETZEN)

nina Vietzen

=LOWER([Column1])

Changes text to lowercase (nina vietzen)

nina Vietzen

=PROPER([Column1])

Changes text to title case (Nina Vietzen)

Combine first and last names

To combine first and last names, use the ampersand operator (&) or the CONCATENATE function.

Column1

Column2

Formula

Description (possible result)

Carlos

Carvallo

=[Column1]&[Column2]

Combines the two strings (CarlosCarvallo)

Carlos

Carvallo

=[Column1]&" "&[Column2]

Combines the two strings, separated by a space (Carlos Carvallo)

Carlos

Carvallo

=[Column2]&", "&[Column1]

Combines the two strings, separated by a comma and a space (Carvallo, Carlos)

Carlos

Carvallo

=CONCATENATE([Column2], ",", [Column1])

Combines the two strings, separated by a comma (Carvallo,Carlos)

Combine text and numbers from different columns

To combine text and numbers, use the CONCATENATE function, the ampersand operator (&), or the TEXT function and the ampersand operator.

Column1

Column2

Formula

Description (possible result)

Yang

28

=[Column1]&" sold "&[Column2]&" units."

Combines contents above into a phrase (Yang sold 28 units.)

Dubois

40%

=[Column1]&" sold "&TEXT([Column2],"0%")&" of the total sales."

Combines contents above into a phrase (Dubois sold 40% of the total sales.)

Note   The TEXT function appends the formatted value of Column2 instead of the underlying value, which is 0.4.

Yang

28

=CONCATENATE([Column1]," sold ",[Column2]," units.")

Combines contents above into a phrase (Yang sold 28 units.)

Combine text with a date or time

To combine text with a date or time, use the TEXT function and the ampersand operator (&).

Column1

Column2

Formula

Description (possible result)

Billing Date

5-Jun-2007

="Statement date: "&TEXT([Column2], "d-mmm-yyyy")

Combines text with a date (Statement date: 5-Jun-2007)

Billing Date

5-Jun-2007

=[Column1]&" "&TEXT([Column2], "mmm-dd-yyyy")

Combines text and date from different columns into one column (Billing Date Jun-05-2007)

Compare column contents

To compare one column to another column or a list of values, use the EXACT and OR functions.

Column1

Column2

Formula

Description (possible result)

BD122

BD123

=EXACT([Column1],[Column2])

Compares contents of first two columns (No)

BD122

BD123

=EXACT([Column1], "BD122")

Compares contents of Column1 and the string "BD122" (Yes)

Determine whether a column value or a part of it matches specific text

To determine whether a column value or a part of it matches specific text, use the IF, FIND, SEARCH, and ISNUMBER functions.

Column1

Formula

Description (possible result)

Vietzen

=IF([Column1]="Vietzen", "OK", "Not OK")

Determines whether Column1 is Vietzen (OK)

Vietzen

=IF(ISNUMBER(FIND("v",[Column1])), "OK", "Not OK")

Determines whether Column1 contains the letter v (OK)

BD123

=ISNUMBER(FIND("BD",[Column1]))

Determines whether Column1 contains BD (Yes)

Count nonblank columns

To count nonblank columns, use the COUNTA function.

Column1

Column2

Column3

Formula

Description (possible result)

Sales

19

=COUNTA([Column1], [Column2])

Counts the number of nonblank columns (2)

Sales

19

=COUNTA([Column1], [Column2], [Column3])

Counts the number of nonblank columns (2)

Remove characters from text

To remove characters from text, use the LEN, LEFT, and RIGHT functions.

Column1

Formula

Description (possible result)

Vitamin A

=LEFT([Column1],LEN([Column1])-2)

Returns 7 (9-2) characters, starting from left (Vitamin)

Vitamin B1

=RIGHT([Column1], LEN([Column1])-8)

Returns 2 (10-8) characters, starting from right (B1)

Remove spaces from the beginning and end of a column

To remove spaces from a column, use the TRIM function.

Column1

Formula

Description (possible result)

Hello there!

=TRIM([Column1])

Removes the spaces from the beginning and end (Hello there!)

Repeat a character in a column

To repeat a character in a column, use the REPT function.

Formula

Description (possible result)

=REPT(".",3)

Repeats a period 3 times (...)

=REPT("-",10)

Repeats a dash 10 times (----------)

See Also

Reference

SPFieldCalculated