[dev-v5] Add DateTimeProvider and DateTimeExtensions #3714

dvoituron · 2025-04-19T15:39:29Z

[dev-v5] Add DateTimeProvider and DateTimeExtensions

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
}
```
Add some DateTimeExtensions methods
Add a method ToTimeAgo(TimeSpan) to return an equivalent localizable string.

Unit Tests

github-actions · 2025-04-19T15:40:53Z

✅ All tests passed successfully

Details on your Workflow / Core Tests page.

github-actions · 2025-04-19T15:40:58Z

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?

src/Core/Localization/ReadMe.md

dvoituron · 2025-04-19T16:53:39Z

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.

dvoituron added 8 commits April 19, 2025 11:05

Add DateTimeProvider and Extension methods

580eeb1

Add Localization readme

cbab490

Add ToTimeAgo extension method

354b8fa

Update the Resc Generator version and the doc

1b8bbca

Add Unit Tests

aff4a86

Add Unit Tests

25ff155

Add Unit Tests

b44a500

Add Unit Tests

eb94f69

dvoituron requested a review from vnbaaij as a code owner April 19, 2025 15:39

dvoituron enabled auto-merge (squash) April 19, 2025 15:41

vnbaaij requested changes Apr 19, 2025

View reviewed changes

src/Core/Localization/ReadMe.md Outdated Show resolved Hide resolved

Fix PR comment

6b84874

vnbaaij approved these changes Apr 19, 2025

View reviewed changes

dvoituron merged commit 4c3f50e into dev-v5 Apr 19, 2025
4 checks passed

dvoituron deleted the users/dvoituron/dev-v5/yearago branch April 19, 2025 21:55

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[dev-v5] Add DateTimeProvider and DateTimeExtensions #3714

[dev-v5] Add DateTimeProvider and DateTimeExtensions #3714

dvoituron commented Apr 19, 2025 •

edited

Loading

github-actions bot commented Apr 19, 2025 •

edited

Loading

github-actions bot commented Apr 19, 2025 •

edited

Loading

vnbaaij left a comment

dvoituron commented Apr 19, 2025

[dev-v5] Add DateTimeProvider and DateTimeExtensions #3714

[dev-v5] Add DateTimeProvider and DateTimeExtensions #3714

Conversation

dvoituron commented Apr 19, 2025 • edited Loading

[dev-v5] Add DateTimeProvider and DateTimeExtensions

Unit Tests

github-actions bot commented Apr 19, 2025 • edited Loading

github-actions bot commented Apr 19, 2025 • edited Loading

Summary - Unit Tests Code Coverage

Coverage

vnbaaij left a comment

Choose a reason for hiding this comment

dvoituron commented Apr 19, 2025

dvoituron commented Apr 19, 2025 •

edited

Loading

github-actions bot commented Apr 19, 2025 •

edited

Loading

github-actions bot commented Apr 19, 2025 •

edited

Loading