DGET function

This article describes the formula syntax and usage of the DGET  function in Microsoft Excel.

Description

Extracts a single value from a column of a list or database that matches conditions that you specify.

Syntax

DGET(database, field, criteria)

The DGET function syntax has the following arguments:

• Database    Required. The range of cells that makes up the list or database. A database is a list of related data in which rows of related information are records, and columns of data are fields. The first row of the list contains labels for each column.

• Field    Required. Indicates which column is used in the function. Enter the column label enclosed between double quotation marks, such as "Age" or "Yield," or a number (without quotation marks) that represents the position of the column within the list: 1 for the first column, 2 for the second column, and so on.

• Criteria    Required. The range of cells that contains the conditions that you specify. You can use any range for the criteria argument, as long as it includes at least one column label and at least one cell below the column label in which you specify a condition for the column.

Remarks

• If no record matches the criteria, DGET returns the #VALUE! error value.

• If more than one record matches the criteria, DGET returns the #NUM! error value.

• You can use any range for the criteria argument, as long as it includes at least one column label and at least one cell below the column label for specifying the condition.

  For example, if the range G1:G2 contains the column label Income in G1 and the amount $10,000 in G2, you could define the range as MatchIncome and use that name as the criteria argument in the database functions.

• Although the criteria range can be located anywhere on the worksheet, do not place the criteria range below the list. If you add more information to the list, the new information is added to the first row below the list. If the row below the list is not blank, Microsoft Excel cannot add the new information.

• Make sure that the criteria range does not overlap the list.

• To perform an operation on an entire column in a database, enter a blank line below the column labels in the criteria range.

Example

Copy the example data in the following table, and paste it in cell A1 of a new Excel worksheet. For formulas to show results, select them, press F2, and then press Enter. If you need to, you can adjust the column widths to see all the data.

Tree	Height	Age	Yield	Profit	Height
="=Apple"	>10				<16
="Pear"	>12
Tree	Height	Age	Yield	Profit
Apple	18	20	14	$105
Pear	12	12	10	$96
Cherry	13	14	9	$105
Apple	14	15	10	$75
Pear	9	8	8	$77
Apple	8	9	6	$45
Formula	Description	Result
=DGET(A5:E11, "Yield", A1:A3)	Returns the #NUM! error value because more than one record meets the criteria (any apple or pear tree).	#NUM!
=DGET(A5:E11, "Yield", A1:F3)	Returns 10 (the yield of the apple tree in row 9) because that is the only record that meets the conditions in A1:F3.	10