Skip to content

$dateToString aggregation with timezone outputs invalid ISO8601 string #1768

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 6 commits into
base: main
Choose a base branch
from
Open

$dateToString aggregation with timezone outputs invalid ISO8601 string #1768

Show file tree
Hide file tree
Changes from 5 commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
281c7a3
make format optional and create testing case about $dateToString aggr…
NathanQingyangXu Jul 17, 2025
9b6b7a3
Update driver-core/src/test/functional/com/mongodb/client/model/mql/T…
NathanQingyangXu Jul 17, 2025
f4f59bd
code change as per review comments
NathanQingyangXu Jul 17, 2025
0954ac5
Update driver-core/src/main/com/mongodb/client/model/mql/MqlExpressio…
NathanQingyangXu Jul 18, 2025
3a4b76b
follow up of the last suggestion commit
NathanQingyangXu Jul 18, 2025
8f68b79
remove unnecessary new method to MqlDate
NathanQingyangXu Jul 28, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions driver-core/src/main/com/mongodb/client/model/mql/MqlDate.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -138,6 +138,20 @@ public interface MqlDate extends MqlValue {
*/
MqlString asString(MqlString timezone, MqlString format);

/**
* The string representation of {@code this} date as determined by the
* provided {@code timezone} with default format as below:
*
* <ul>
* <li>If {@code timezone} is UTC timezone, {@code "%Y-%m-%dT%H:%M:%S.%LZ"} will be the default
* <li>Otherwise the default format will be {@code "%Y-%m-%dT%H:%M:%S.%L"}
* </ul>
*
* @param timezone the UTC Offset or Olson Timezone Identifier.
* @return the resulting value.
*/
MqlString asString(MqlString timezone);
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why add this to the external API? This would expose a method that would always fail.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

removed. I misunderstood something.


/**
* The result of passing {@code this} value to the provided function.
* Equivalent to {@code f.apply(this)}, and allows lambdas and static,
Expand Down
5 changes: 5 additions & 0 deletions driver-core/src/main/com/mongodb/client/model/mql/MqlExpression.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@
import java.util.function.BinaryOperator;
import java.util.function.Function;

import static com.mongodb.assertions.Assertions.fail;
import static com.mongodb.client.model.mql.MqlValues.of;
import static com.mongodb.client.model.mql.MqlValues.ofNull;
import static com.mongodb.client.model.mql.MqlValues.ofStringArray;
Expand Down Expand Up @@ -953,6 +954,10 @@ public MqlString asString(final MqlString timezone, final MqlString format) {
.append("timezone", toBsonValue(cr, timezone))));
}

public MqlString asString(final MqlString timezone) {
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe that we do not need this method, and that it might actually be introducing the bug described in the Jira. That is, the API as it is now intentionally prevents the user from specifying a timezone without also forcing that user to explicitly specify a format, thus preventing the situation from arising.

For reference:

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks for sharing. Yeah, also saw you raising the point in our team slack channel. I have no objection of closing this PR.

throw fail(); // intentionally not implemented, see DRIVERS-2620
Copy link
Member

@vbabanin vbabanin Aug 7, 2025 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could we add additional context in this comment on why we decided to not implement it? This would help us to recollect the rationale in the future.

For example: Given that server versions < ... return a wrong format, not implementing this method helps prevent users from encountering that bug by avoiding the method that requires a format as a parameter.

}

@Override
public MqlDate parseDate(final MqlString timezone, final MqlString format) {
Assertions.notNull("timezone", timezone);
Expand Down