diff --git a/spring-data-mongodb/src/main/java/org/springframework/data/mongodb/core/aggregation/DateOperators.java b/spring-data-mongodb/src/main/java/org/springframework/data/mongodb/core/aggregation/DateOperators.java
index 7dc705625..3afee36e9 100644
--- a/spring-data-mongodb/src/main/java/org/springframework/data/mongodb/core/aggregation/DateOperators.java
+++ b/spring-data-mongodb/src/main/java/org/springframework/data/mongodb/core/aggregation/DateOperators.java
@@ -21,6 +21,7 @@ import java.util.Map;
import org.springframework.util.Assert;
import org.springframework.util.ObjectUtils;
+import org.springframework.util.StringUtils;
/**
* Gateway to {@literal Date} aggregation operations.
@@ -175,7 +176,7 @@ public class DateOperators {
* Create a {@link Timezone} for the {@link AggregationExpression} resulting in the Olson Timezone Identifier or UTC
* Offset.
*
- * @param value the {@link AggregationExpression} resulting in the timezone.
+ * @param expression the {@link AggregationExpression} resulting in the timezone.
* @return new instance of {@link Timezone}.
*/
public static Timezone ofExpression(AggregationExpression expression) {
@@ -375,6 +376,17 @@ public class DateOperators {
return applyTimezone(DateToString.dateToString(dateReference()).toString(format), timezone);
}
+ /**
+ * Creates new {@link AggregationExpression} that converts a date object to a string according to the server default
+ * format.
+ *
+ * @return new instance of {@link DateToString}.
+ * @since 1.10.15
+ */
+ public DateToString toStringWithDefaultFormat() {
+ return applyTimezone(DateToString.dateToString(dateReference()).defaultFormat(), timezone);
+ }
+
/**
* Creates new {@link AggregationExpression} that returns the weekday number in ISO 8601 format, ranging from 1 (for
* Monday) to 7 (for Sunday).
@@ -1344,6 +1356,11 @@ public class DateOperators {
Assert.notNull(format, "Format must not be null!");
return new DateToString(argumentMap(value, format, Timezone.none()));
}
+
+ @Override
+ public DateToString defaultFormat() {
+ return new DateToString(argumentMap(value, null, Timezone.none()));
+ }
};
}
@@ -1387,6 +1404,42 @@ public class DateOperators {
return new DateToString(argumentMap(get("date"), (String) get("format"), timezone));
}
+ /**
+ * Optionally specify the value to return when the date is {@literal null} or missing.
+ * NOTE: Requires MongoDB 4.0 or later.
+ *
+ * @param value must not be {@literal null}.
+ * @return new instance of {@link DateToString}.
+ * @since 1.10.15
+ */
+ public DateToString onNullReturn(Object value) {
+ return new DateToString(append("onNull", value));
+ }
+
+ /**
+ * Optionally specify the field holding the value to return when the date is {@literal null} or missing.
+ * NOTE: Requires MongoDB 4.0 or later.
+ *
+ * @param fieldReference must not be {@literal null}.
+ * @return new instance of {@link DateToString}.
+ * @since 1.10.15
+ */
+ public DateToString onNullReturnValueOf(String fieldReference) {
+ return onNullReturn(Fields.field(fieldReference));
+ }
+
+ /**
+ * Optionally specify the expression to evaluate and return when the date is {@literal null} or missing.
+ * NOTE: Requires MongoDB 4.0 or later.
+ *
+ * @param expression must not be {@literal null}.
+ * @return new instance of {@link DateToString}.
+ * @since 1.10.15
+ */
+ public DateToString onNullReturnValueOf(AggregationExpression expression) {
+ return onNullReturn(expression);
+ }
+
@Override
protected String getMongoMethod() {
return "$dateToString";
@@ -1395,7 +1448,11 @@ public class DateOperators {
private static java.util.Map argumentMap(Object date, String format, Timezone timezone) {
java.util.Map args = new LinkedHashMap(2);
- args.put("format", format);
+
+ if (StringUtils.hasText(format)) {
+ args.put("format", format);
+ }
+
args.put("date", date);
if (!ObjectUtils.nullSafeEquals(timezone, Timezone.none())) {
@@ -1413,6 +1470,16 @@ public class DateOperators {
* @return
*/
DateToString toString(String format);
+
+ /**
+ * Creates new {@link DateToString} using the server default string format ({@code %Y-%m-%dT%H:%M:%S.%LZ}) for
+ * dates.
+ * NOTE: Requires MongoDB 4.0 or later.
+ *
+ * @return new instance of {@link DateToString}.
+ * @since 1.10.15
+ */
+ DateToString defaultFormat();
}
}
@@ -2278,6 +2345,21 @@ public class DateOperators {
return new DateFromString(appendTimezone(argumentMap(), timezone));
}
+ /**
+ * Optionally set the date format to use. If not specified {@code %Y-%m-%dT%H:%M:%S.%LZ} is used.
+ * NOTE: Requires MongoDB 4.0 or later.
+ *
+ * @param format must not be {@literal null}.
+ * @return new instance of {@link DateFromString}.
+ * @throws IllegalArgumentException if given {@literal format} is {@literal null}.
+ * @since 1.10.15
+ */
+ public DateFromString withFormat(String format) {
+
+ Assert.notNull(format, "Format must not be null!");
+ return new DateFromString(append("format", format));
+ }
+
@Override
protected String getMongoMethod() {
return "$dateFromString";
diff --git a/spring-data-mongodb/src/main/java/org/springframework/data/mongodb/core/aggregation/ProjectionOperation.java b/spring-data-mongodb/src/main/java/org/springframework/data/mongodb/core/aggregation/ProjectionOperation.java
index 0d6cb4732..4385dd533 100644
--- a/spring-data-mongodb/src/main/java/org/springframework/data/mongodb/core/aggregation/ProjectionOperation.java
+++ b/spring-data-mongodb/src/main/java/org/springframework/data/mongodb/core/aggregation/ProjectionOperation.java
@@ -1210,6 +1210,18 @@ public class ProjectionOperation implements FieldsExposingAggregationOperation {
return this.operation.and(DateOperators.DateToString.dateOf(name).toString(format));
}
+ /**
+ * Generates a {@code $dateToString} expression that takes the date representation of the previously mentioned field
+ * using the server default format.
+ * strong>NOTE: Requires MongoDB 4.0 or later.
+ *
+ * @return
+ * @since 1.10.15
+ */
+ public ProjectionOperationBuilder dateAsFormattedString() {
+ return this.operation.and(DateOperators.DateToString.dateOf(name).defaultFormat());
+ }
+
/**
* Generates a {@code $let} expression that binds variables for use in the specified expression, and returns the
* result of the expression.
diff --git a/spring-data-mongodb/src/test/java/org/springframework/data/mongodb/core/aggregation/ProjectionOperationUnitTests.java b/spring-data-mongodb/src/test/java/org/springframework/data/mongodb/core/aggregation/ProjectionOperationUnitTests.java
index 1731b4fa5..5084f0ae8 100644
--- a/spring-data-mongodb/src/test/java/org/springframework/data/mongodb/core/aggregation/ProjectionOperationUnitTests.java
+++ b/spring-data-mongodb/src/test/java/org/springframework/data/mongodb/core/aggregation/ProjectionOperationUnitTests.java
@@ -1283,6 +1283,14 @@ public class ProjectionOperationUnitTests {
is(JSON.parse("{ $project: { time: { $dateToString: { format: \"%H:%M:%S:%L\", date: \"$date\" } } } }")));
}
+ @Test // DATAMONGO-2047
+ public void shouldRenderDateToStringWithoutFormatOption() {
+
+ DBObject agg = project().and("date").dateAsFormattedString().as("time").toDBObject(Aggregation.DEFAULT_CONTEXT);
+
+ assertThat(agg, is(JSON.parse("{ $project: { time: { $dateToString: { date: \"$date\" } } } }")));
+ }
+
@Test // DATAMONGO-1536
public void shouldRenderDateToStringAggregationExpression() {
@@ -1304,6 +1312,17 @@ public class ProjectionOperationUnitTests {
"{ $project: { time: { $dateToString: { format: \"%H:%M:%S:%L\", date: \"$date\", \"timezone\" : \"America/Chicago\" } } } } } }")));
}
+ @Test // DATAMONGO-2047
+ public void shouldRenderDateToStringWithOnNull() {
+
+ DBObject agg = project()
+ .and(DateOperators.dateOf("date").toStringWithDefaultFormat().onNullReturnValueOf("fallback-field")).as("time")
+ .toDBObject(Aggregation.DEFAULT_CONTEXT);
+
+ assertThat(agg, is(JSON
+ .parse("{ $project: { time: { $dateToString: { date: \"$date\", \"onNull\" : \"$fallback-field\" } } } }")));
+ }
+
@Test // DATAMONGO-1536
public void shouldRenderSumAggregationExpression() {
@@ -1997,6 +2016,16 @@ public class ProjectionOperationUnitTests {
"{ $project : { newDate: { $dateFromString: { dateString : \"2017-02-08T12:10:40.787\", timezone : \"America/Chicago\" } } } }")));
}
+ @Test // DATAMONGO-2047
+ public void shouldRenderDateFromStringWithFormat() {
+
+ DBObject agg = project().and(DateOperators.dateFromString("2017-02-08T12:10:40.787").withFormat("dd/mm/yyyy"))
+ .as("newDate").toDBObject(Aggregation.DEFAULT_CONTEXT);
+
+ assertThat(agg, is(JSON.parse(
+ "{ $project : { newDate: { $dateFromString: { dateString : \"2017-02-08T12:10:40.787\", format : \"dd/mm/yyyy\" } } } }")));
+ }
+
private static DBObject exctractOperation(String field, DBObject fromProjectClause) {
return (DBObject) fromProjectClause.get(field);
}