Reference documentation and code samples for the Cloud Firestore Client class Aggregate.
Represents Aggregate properties.
Example:
$count = Aggregate::count();
$count->alias('count');
echo json_encode($count->getProps());
Namespace
Google \ Cloud \ FirestoreMethods
alias
Set the aggregate alias.
Example:
$count = Aggregate->count();
$count->alias('total');
echo $count->props()['alias'];
Parameter | |
---|---|
Name | Description |
alias |
string
The alias for aggregate. |
Returns | |
---|---|
Type | Description |
Google\Cloud\Firestore\Aggregate |
getProps
Get the array representation for the aggregate.
Returns | |
---|---|
Type | Description |
array |
static::count
Creates count aggregation properties.
Example:
$count = Aggregate::count();
Returns | |
---|---|
Type | Description |
Google\Cloud\Firestore\Aggregate |
static::sum
Creates sum aggregation properties.
Example:
$sum = Aggregate::sum('field_to_aggregate_upon');
Result of SUM aggregation can be a integer or a float.
Sum of integers which exceed maxinum integer value returns a float.
Sum of numbers exceeding max float value returns INF
.
Sum of data which contains NaN
returns NaN
.
Non numeric values are ignored.
Parameter | |
---|---|
Name | Description |
field |
string
The relative path of the field to aggregate upon. |
Returns | |
---|---|
Type | Description |
Google\Cloud\Firestore\Aggregate |
static::avg
Creates average aggregation properties.
Example:
$avg = Aggregate::avg('field_to_aggregate_upon');
Result of AVG aggregation can be a float or a null.
Average of empty valid data set return null
.
Average of numbers exceeding max float value returns INF
.
Average of data which contains NaN
returns NaN
.
Non numeric values are ignored.
Parameter | |
---|---|
Name | Description |
field |
string|null
The relative path of the field to aggregate upon. |
Returns | |
---|---|
Type | Description |
Google\Cloud\Firestore\Aggregate |