Contents:
NOTE: When added to a transformation, this function is applied to the current sample. If you change your sample or run the job, the computed values for this function are updated. Transformations that change the number of rows in subsequent recipe steps do not affect the values computed for this step.
To calculate the minimum Datetime value of rows without conditionals, use the MINDATE function. See MINDATE Function.
Wrangle vs. SQL: This function is part of Wrangle, a proprietary data transformation language. Wrangle is not SQL. For more information, see Wrangle Language.
Basic Usage
mindateif(incidentDate, serverFailure == 'true')
Output: Returns the minimum date from the incidentDate column when the value in the serverFailure column is true.
Syntax and Arguments
mindateif(col_ref, test_expression) [group:group_col_ref] [limit:limit_count]
| Argument | Required? | Data Type | Description |
|---|---|---|---|
| col_ref | Y | string | Reference to the column you wish to evaluate. Values in the columns must be valid Date values. |
| test_expression | Y | string | Expression that is evaluated. Must resolve to true or false |
For more information on syntax standards, see Language Documentation Syntax Notes.
For more information on the group and limit parameters, see Pivot Transform.
col_ref
Name of the column whose values you wish to use in the calculation. Inputs must be Datetime values.
Usage Notes:
| Required? | Data Type | Example Value |
|---|---|---|
| Yes | String that corresponds to the name of the column | myDates |
test_expression
This parameter contains the expression to evaluate. This expression must resolve to a Boolean (true or false) value.
Usage Notes:
| Required? | Data Type | Example Value |
|---|---|---|
| Yes | String expression that evaluates to true or false | (LastName == 'Mouse' && FirstName == 'Mickey')
|
Tip: For additional examples, see Common Tasks.
Examples
Example - DATEIF Functions
Functions:
| Item | Description |
|---|---|
| MINDATEIF Function | Returns the minimum Datetime value of rows in each group that meet a specific condition. Set of values must valid Datetime values. |
| MAXDATEIF Function | Returns the maximum Datetime value of rows in each group that meet a specific condition. Set of values must valid Datetime values. |
| MODEDATEIF Function | Returns the most common Datetime value of rows in each group that meet a specific condition. Set of values must valid Datetime values. |
Source:
Here is some example transaction data:
| Date | Product | Units | UnitCost | OrderValue |
|---|---|---|---|---|
| 3/28/2020 | ProductA | 4 | 10.00 | 40.00 |
| 3/8/2020 | ProductB | 4 | 20.00 | 80.00 |
| 3/12/2020 | ProductC | 2 | 30.00 | 60.00 |
| 3/23/2020 | ProductA | 1 | 10.00 | 10.00 |
| 3/20/2020 | ProductB | 2 | 20.00 | 40.00 |
| 3/12/2020 | ProductC | 9 | 30.00 | 270.00 |
| 3/28/2020 | ProductA | 5 | 10.00 | 50.00 |
| 3/23/2020 | ProductB | 8 | 20.00 | 160.00 |
| 3/16/2020 | ProductC | 9 | 30.00 | 270.00 |
| 3/8/2020 | ProductA | 5 | 10.00 | 50.00 |
| 3/10/2020 | ProductB | 3 | 20.00 | 60.00 |
| 3/13/2020 | ProductC | 1 | 30.00 | 30.00 |
| 3/12/2020 | ProductA | 7 | 10.00 | 70.00 |
| 3/10/2020 | ProductB | 7 | 20.00 | 140.00 |
| 3/24/2020 | ProductC | 9 | 30.00 | 270.00 |
| 3/15/2020 | ProductA | 8 | 10.00 | 80.00 |
| 3/10/2020 | ProductB | 5 | 20.00 | 100.00 |
| 3/10/2020 | ProductC | 4 | 30.00 | 120.00 |
Transformation and Results:
These functions are useful for asking questions about your data. In the following, you can review specific questions and see the results immediately.
Question 1: What is the earliest date when a $100.00 transaction occurred?
| Transformation Name | New formula |
|---|---|
| Parameter: Formula type | Single row formula |
| Parameter: Formula | mindateif(Date, OrderValue > 100) |
| Parameter: New column name | 'Answers' |
Results: Value in Answers column: 3/10/2020
Question 2: What is the latest date when a $200.00 transaction occurred?
| Transformation Name | New formula |
|---|---|
| Parameter: Formula type | Single row formula |
| Parameter: Formula | maxdateif(Date, OrderValue > 200) |
| Parameter: New column name | 'Answer' |
Results: Value in Answers column: 3/24/2020
Question 3: On what date did the most transactions occur this month?
| Transformation Name | New formula |
|---|---|
| Parameter: Formula type | Single row formula |
| Parameter: Formula | modedateif(Date, OrderValue > 0) |
| Parameter: New column name | 'Answer' |
Results: Value in Answers column: 3/10/2020
This page has no comments.