Add the support of DateOnly and TimeOnly types in TryParse method Utf8Parser class

[goldytech]

Background and Motivation

In .the current version of .NET (5.0.203) Utf8Parser class has only support for DateTime.
https://docs.microsoft.com/en-us/dotnet/api/system.buffers.text.utf8parser.tryparse?view=net-5.0#System_Buffers_Text_Utf8Parser_TryParse_System_ReadOnlySpan_System_Byte__System_DateTime__System_Int32__System_Char_

With .NET 6 Preview 4 two new types have been introduced DateOnly and TimeOnly. It would be good to have the support of these two types in the TryParse method of Utf8Parser class. In the current version if the date is only passed without time the out variable returns a null value. I believe there will be legitimate UseCases where only date and time parsing are required explicitly. In order to extract the DateTime now , developers have to fallback to Encoding.UTF8.GetString() and then use DateTime.TryParse() method to get the date / time value. This is resource intensive operation and allocations get increased.
Eg.

if (DateTime.TryParse(Encoding.UTF8.GetString(buffer, out var dateofJoining))

                           {
                                 record.DateOfJoining = dateofJoining;
                            }  

Proposed API

Additional two overload methods must be added to current Utf8Parser static class to support DateOnly and TimeOnly types.

Usage Examples

Eg
For DateOnly type

if (Utf8Parser.TryParse(buffer, out DateOnly value, out var bytesConsumed))
                                {
                                    record.DateOfJoining = value;
                                }

For TimeOnly type

if (Utf8Parser.TryParse(buffer, out TimeOnly value, out var bytesConsumed))
                                {
                                    record.ApplicationTime = value;
                                }

Alternative Designs

Risks

[dotnet-issue-labeler]

I couldn't figure out the best area label to add to this issue. If you have write-permissions please help me learn by adding exactly one area label.

[ghost]

Tagging subscribers to this area: @tarekgh, @safern
See info in area-owners.md if you want to be subscribed.

Issue Details

---

Background and Motivation

In .the current version of .NET (5.0.203) Utf8Parser class has only support for DateTime.
https://docs.microsoft.com/en-us/dotnet/api/system.buffers.text.utf8parser.tryparse?view=net-5.0#System_Buffers_Text_Utf8Parser_TryParse_System_ReadOnlySpan_System_Byte__System_DateTime__System_Int32__System_Char_

With .NET 6 Preview 4 two new types have been introduced DateOnly and TimeOnly. It would be good to have the support of these two types in the TryParse method of Utf8Parser class. In the current version if the date is only passed without time the out variable returns a null value. I believe there will be legitimate UseCases where only date and time parsing are required explicitly. In order to extract the DateTime now , developers have to fallback to Encoding.UTF8.GetString() and then use DateTime.TryParse() method to get the date / time value. This is resource intensive operation and allocations get increased.
Eg.

if (DateTime.TryParse(Encoding.UTF8.GetString(buffer, out var dateofJoining))

                           {
                                 record.DateOfJoining = dateofJoining;
                            }  

Proposed API

Additional two overload methods must be added to current Utf8Parser static class to support DateOnly and TimeOnly types.

Usage Examples

Eg
For DateOnly type

if (Utf8Parser.TryParse(buffer, out DateOnly value, out var bytesConsumed))
                                {
                                    record.DateOfJoining = value;
                                }

For TimeOnly type

if (Utf8Parser.TryParse(buffer, out TimeOnly value, out var bytesConsumed))
                                {
                                    record.ApplicationTime = value;
                                }

Alternative Designs

Risks

Author:	goldytech
Assignees:	-
Labels:	api-suggestion, area-System.Globalization, untriaged
Milestone:	-

[ghost]

Tagging subscribers to this area: @tannergooding
See info in area-owners.md if you want to be subscribed.

Issue Details

---

Background and Motivation

In .the current version of .NET (5.0.203) Utf8Parser class has only support for DateTime.
https://docs.microsoft.com/en-us/dotnet/api/system.buffers.text.utf8parser.tryparse?view=net-5.0#System_Buffers_Text_Utf8Parser_TryParse_System_ReadOnlySpan_System_Byte__System_DateTime__System_Int32__System_Char_

With .NET 6 Preview 4 two new types have been introduced DateOnly and TimeOnly. It would be good to have the support of these two types in the TryParse method of Utf8Parser class. In the current version if the date is only passed without time the out variable returns a null value. I believe there will be legitimate UseCases where only date and time parsing are required explicitly. In order to extract the DateTime now , developers have to fallback to Encoding.UTF8.GetString() and then use DateTime.TryParse() method to get the date / time value. This is resource intensive operation and allocations get increased.
Eg.

if (DateTime.TryParse(Encoding.UTF8.GetString(buffer, out var dateofJoining))

                           {
                                 record.DateOfJoining = dateofJoining;
                            }  

Proposed API

Additional two overload methods must be added to current Utf8Parser static class to support DateOnly and TimeOnly types.

Usage Examples

Eg
For DateOnly type

if (Utf8Parser.TryParse(buffer, out DateOnly value, out var bytesConsumed))
                                {
                                    record.DateOfJoining = value;
                                }

For TimeOnly type

if (Utf8Parser.TryParse(buffer, out TimeOnly value, out var bytesConsumed))
                                {
                                    record.ApplicationTime = value;
                                }

Alternative Designs

Risks

Author:	goldytech
Assignees:	-
Labels:	api-suggestion, area-System.Runtime
Milestone:	-

[ghost]

Tagging subscribers to this area: @tannergooding, @pgovind, @GrabYourPitchforks
See info in area-owners.md if you want to be subscribed.

Issue Details

---

Background and Motivation

In .the current version of .NET (5.0.203) Utf8Parser class has only support for DateTime.
https://docs.microsoft.com/en-us/dotnet/api/system.buffers.text.utf8parser.tryparse?view=net-5.0#System_Buffers_Text_Utf8Parser_TryParse_System_ReadOnlySpan_System_Byte__System_DateTime__System_Int32__System_Char_

With .NET 6 Preview 4 two new types have been introduced DateOnly and TimeOnly. It would be good to have the support of these two types in the TryParse method of Utf8Parser class. In the current version if the date is only passed without time the out variable returns a null value. I believe there will be legitimate UseCases where only date and time parsing are required explicitly. In order to extract the DateTime now , developers have to fallback to Encoding.UTF8.GetString() and then use DateTime.TryParse() method to get the date / time value. This is resource intensive operation and allocations get increased.
Eg.

if (DateTime.TryParse(Encoding.UTF8.GetString(buffer, out var dateofJoining))

                           {
                                 record.DateOfJoining = dateofJoining;
                            }  

Proposed API

Additional two overload methods must be added to current Utf8Parser static class to support DateOnly and TimeOnly types.

Usage Examples

Eg
For DateOnly type

if (Utf8Parser.TryParse(buffer, out DateOnly value, out var bytesConsumed))
                                {
                                    record.DateOfJoining = value;
                                }

For TimeOnly type

if (Utf8Parser.TryParse(buffer, out TimeOnly value, out var bytesConsumed))
                                {
                                    record.ApplicationTime = value;
                                }

Alternative Designs

Risks

Author:	goldytech
Assignees:	-
Labels:	api-suggestion, area-System.Buffers
Milestone:	Future

[tarekgh]

#53539
#51302

[teo-tsirpanis]

And Half. And corresponding members in Utf8Formatter.

[tannergooding]

@teo-tsirpanis could you open a separate proposal for Half?

[bartonjs]

Video

Rather than adding things on Utf8Parser, the plan forward is to add the UTF-8 parse methods to the relevant types themselves (generally along with implementing IUtf8SpanParsable.

For DateOnly and TimeOnly, these API additions are already covered under #81500.

It came up in discussion that DateOnly (and maybe TimeOnly) might want more options than the simple parse, like DateTime.TryParseExact has, but those would just be overloads to the TryParse methods on their types, and still wouldn't affect Utf8Parser. As those also weren't part of this original proposal, they're left for someone else to do the research on and create a dedicated issue for.