[dev-v5] Add DateTimeProvider and DateTimeExtensions

[dvoituron]

[dev-v5] Add DateTimeProvider and DateTimeExtensions

1. Add a DateTimeProvider and DateTimeProviderContext
   See the ReadMe.md documentation in the Utilities/DateTime folder.

   To simplify the possibility to unit test a current Date Time,
   we propose a solution that uses the Ambient Context Model.

   To do this, use a DateTimeProvider class that determines the current date:
   the default DateTime.Now is replaced by DateTimeProvider.Now in the code.

   Example:

   int GetQuarter()
   {
       return (DateTimeProvider.Today.Month - 1) / 3 + 1;
   }

   This provider returns the system's current date. However, by using it in a unit test,
   we can adapt the context to specify a predefined (fake / fixed) date.

   var fakeDate = new DateTime(2018, 5, 26);
   using (var context = new DateTimeProviderContext(fakeDate))
   {
       var quarter = GetQuarter();  // 2
   }

2. Add some DateTimeExtensions methods

3. Add a method ToTimeAgo(TimeSpan) to return an equivalent localizable string.

Unit Tests

[github-actions]

✅ All tests passed successfully

Details on your Workflow / Core Tests page.

[github-actions]

Summary - Unit Tests Code Coverage

Summary

Generated on:	04/19/2025 - 21:56:34
Coverage date:	04/19/2025 - 21:56:27
Parser:	Cobertura
Assemblies:	1
Classes:	119
Files:	156
Line coverage:	99.4% (2951 of 2968)
Covered lines:	2951
Uncovered lines:	17
Coverable lines:	2968
Total lines:	12869
Branch coverage:	93.4% (1708 of 1828)
Covered branches:	1708
Total branches:	1828
Method coverage:	Feature is only available for sponsors
Tag:	3411_14553204395

Coverage

Microsoft.FluentUI.AspNetCore.Components - 99.4%

Name	Line	Branch
Microsoft.FluentUI.AspNetCore.Components	99.4%	93.4%
Microsoft.FluentUI.AspNetCore.Components.AccordionItemEventArgs	100%
Microsoft.FluentUI.AspNetCore.Components.AdditionalAttributesExtensions	100%	100%
Microsoft.FluentUI.AspNetCore.Components.CachedServices	100%	100%
Microsoft.FluentUI.AspNetCore.Components.DateTimeProvider	100%	100%
Microsoft.FluentUI.AspNetCore.Components.DateTimeProviderContext	95.6%	92.8%
Microsoft.FluentUI.AspNetCore.Components.DefaultStyles	100%
Microsoft.FluentUI.AspNetCore.Components.Dialog.MessageBox.FluentMessageBox	100%	100%
Microsoft.FluentUI.AspNetCore.Components.DialogEventArgs	100%	92.8%
Microsoft.FluentUI.AspNetCore.Components.DialogInstance	100%	100%
Microsoft.FluentUI.AspNetCore.Components.DialogOptions	100%
Microsoft.FluentUI.AspNetCore.Components.DialogOptionsFooter	100%	100%
Microsoft.FluentUI.AspNetCore.Components.DialogOptionsFooterAction	100%	100%
Microsoft.FluentUI.AspNetCore.Components.DialogOptionsHeader	100%
Microsoft.FluentUI.AspNetCore.Components.DialogResult	100%	100%
Microsoft.FluentUI.AspNetCore.Components.DialogResult`1	100%
Microsoft.FluentUI.AspNetCore.Components.DialogService	98.9%	81.4%
Microsoft.FluentUI.AspNetCore.Components.DialogToggleEventArgs	100%
Microsoft.FluentUI.AspNetCore.Components.DropdownEventArgs	100%
Microsoft.FluentUI.AspNetCore.Components.Extensions.DateTimeExtensions	100%	92%
Microsoft.FluentUI.AspNetCore.Components.Extensions.EnumExtensions	100%	100%
Microsoft.FluentUI.AspNetCore.Components.Extensions.FieldSizeExtensions	100%	100%
Microsoft.FluentUI.AspNetCore.Components.Extensions.FluentInputExtensions	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentAccordion	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentAccordionItem	100%	95%
Microsoft.FluentUI.AspNetCore.Components.FluentAnchorButton	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentAvatar	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentBadge	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentButton	98.4%	90.6%
Microsoft.FluentUI.AspNetCore.Components.FluentCheckbox	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentCombobox`1	100%
Microsoft.FluentUI.AspNetCore.Components.FluentComponentBase	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentCompoundButton	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentCounterBadge	100%	96.1%
Microsoft.FluentUI.AspNetCore.Components.FluentDialog	97.4%	89.7%
Microsoft.FluentUI.AspNetCore.Components.FluentDialogBody	100%	91.6%
Microsoft.FluentUI.AspNetCore.Components.FluentDialogInstance	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentDialogProvider	100%	80%
Microsoft.FluentUI.AspNetCore.Components.FluentDivider	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentField	100%	96.5%
Microsoft.FluentUI.AspNetCore.Components.FluentFieldCondition	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentFieldConditionItem	100%
Microsoft.FluentUI.AspNetCore.Components.FluentFieldConditionOptions	100%
Microsoft.FluentUI.AspNetCore.Components.FluentFieldExtensions	100%
Microsoft.FluentUI.AspNetCore.Components.FluentFieldParameterSelector	100%	98.7%
Microsoft.FluentUI.AspNetCore.Components.FluentGrid	100%	90%
Microsoft.FluentUI.AspNetCore.Components.FluentGridItem	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentHighlighter	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentIcon`1	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentImage	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentInputBase`1	93.7%	43.7%
Microsoft.FluentUI.AspNetCore.Components.FluentInputImmediateBase`1	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentJSModule	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentLabel	100%
Microsoft.FluentUI.AspNetCore.Components.FluentLayout	100%	85%
Microsoft.FluentUI.AspNetCore.Components.FluentLayoutHamburger	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentLayoutItem	100%	87.7%
Microsoft.FluentUI.AspNetCore.Components.FluentLink	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentListBase`1	98.4%	92.8%
Microsoft.FluentUI.AspNetCore.Components.FluentLocalizerExtensions	100%
Microsoft.FluentUI.AspNetCore.Components.FluentLocalizerInternal	100%
Microsoft.FluentUI.AspNetCore.Components.FluentMenu	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentMenuButton	100%	71.4%
Microsoft.FluentUI.AspNetCore.Components.FluentMenuItem	100%	90.4%
Microsoft.FluentUI.AspNetCore.Components.FluentMenuList	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentMultiSplitter	100%	91.8%
Microsoft.FluentUI.AspNetCore.Components.FluentMultiSplitterEventArgs	100%
Microsoft.FluentUI.AspNetCore.Components.FluentMultiSplitterPane	100%	89.4%
Microsoft.FluentUI.AspNetCore.Components.FluentMultiSplitterResizeEventArgs	100%
Microsoft.FluentUI.AspNetCore.Components.FluentOption	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentProgressBar	100%	95.4%
Microsoft.FluentUI.AspNetCore.Components.FluentProviders	100%
Microsoft.FluentUI.AspNetCore.Components.FluentRadio`1	100%	50%
Microsoft.FluentUI.AspNetCore.Components.FluentRadioContext	100%	75%
Microsoft.FluentUI.AspNetCore.Components.FluentRadioGroup`1	100%
Microsoft.FluentUI.AspNetCore.Components.FluentRatingDisplay	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentSelect`1	100%
Microsoft.FluentUI.AspNetCore.Components.FluentServiceBase`1	100%
Microsoft.FluentUI.AspNetCore.Components.FluentServiceProviderException`1	100%
Microsoft.FluentUI.AspNetCore.Components.FluentSlider`1	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentSpacer	100%
Microsoft.FluentUI.AspNetCore.Components.FluentSpinner	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentSplitButton	100%
Microsoft.FluentUI.AspNetCore.Components.FluentStack	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentStatus	100%
Microsoft.FluentUI.AspNetCore.Components.FluentSwitch	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentTab	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentTabs	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentText	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FluentTextArea	100%	66.6%
Microsoft.FluentUI.AspNetCore.Components.FluentTextInput	100%	78.5%
Microsoft.FluentUI.AspNetCore.Components.FluentToggleButton	100%	91.6%
Microsoft.FluentUI.AspNetCore.Components.FluentTooltip	100%	95%
Microsoft.FluentUI.AspNetCore.Components.FluentTooltipProvider	100%	100%
Microsoft.FluentUI.AspNetCore.Components.FreeOptionOutput	100%
Microsoft.FluentUI.AspNetCore.Components.HighlighterSplitter	100%	100%
Microsoft.FluentUI.AspNetCore.Components.Icon	100%	89.4%
Microsoft.FluentUI.AspNetCore.Components.IconFromImage	100%
Microsoft.FluentUI.AspNetCore.Components.IconInfo	100%
Microsoft.FluentUI.AspNetCore.Components.IFluentLocalizer	100%	100%
Microsoft.FluentUI.AspNetCore.Components.InternalListContext`1	100%
Microsoft.FluentUI.AspNetCore.Components.LibraryTooltipOptions	100%
Microsoft.FluentUI.AspNetCore.Components.Localization.LanguageResource	100%	100%
Microsoft.FluentUI.AspNetCore.Components.MenuItemEventArgs	100%
Microsoft.FluentUI.AspNetCore.Components.MessageBoxOptions	100%
Microsoft.FluentUI.AspNetCore.Components.Migration.AppearanceExtensions	100%	100%
Microsoft.FluentUI.AspNetCore.Components.Migration.FluentInputAppearanceExt ensions	100%	100%
Microsoft.FluentUI.AspNetCore.Components.Migration.TooltipPositionExtension	100%	100%
Microsoft.FluentUI.AspNetCore.Components.ServiceProviderExtensions	100%
Microsoft.FluentUI.AspNetCore.Components.SpacingExtensions	100%	97.2%
Microsoft.FluentUI.AspNetCore.Components.TabChangeEventArgs	100%
Microsoft.FluentUI.AspNetCore.Components.TooltipEventArgs	100%
Microsoft.FluentUI.AspNetCore.Components.Utilities.AddTag	100%	100%
Microsoft.FluentUI.AspNetCore.Components.Utilities.CssBuilder	100%	100%
Microsoft.FluentUI.AspNetCore.Components.Utilities.Identifier	100%	100%
Microsoft.FluentUI.AspNetCore.Components.Utilities.IdentifierContext	100%	75%
Microsoft.FluentUI.AspNetCore.Components.Utilities.InlineStyleBuilder	100%	92.8%
Microsoft.FluentUI.AspNetCore.Components.Utilities.InternalDebounce.Dispatc herTimerExtensions	82.9%	68.7%
Microsoft.FluentUI.AspNetCore.Components.Utilities.StyleBuilder	100%	100%
Microsoft.FluentUI.AspNetCore.Components.ZIndex	100%

[vnbaaij]

Should we not also have these extensions and helpers for DateTimeOffset?

[dvoituron]

Good question. This is the v4 extension file. And at this moment the v4 don't use DateTimeOffset extensions.

So I propose to add these extensions later, only if we need it.