Skip to content

Latest commit

 

History

History
101 lines (72 loc) · 4.38 KB

README-OLD.md

File metadata and controls

101 lines (72 loc) · 4.38 KB

Blazor WebAssembly App (client-side) Time Zone Kit NuGet Package

Summary

This is a class library as a NuGet package for Blazor WebAssembly (client-side) browser application.

This package provides system time zones set, and local time zone initialization, for Blazor WebAssembly (client-side) browser application.

fig. 1

Note

At this time, the latest version of the client-side Blazor WebAssembly app is v.3.2 Preview 4, it doesn't contain any time zone info, and local time zone is always UTC wherever.

See also:

Supported Blazor versions

"Blazor WebAssembly App (client-side) Time Zone Kit" ver.7.x supports Blazor WebAssembly App versions 3.2 Preview 2~4.

How to install and use it?

Step.1 - Install this package.

> dotnet add package Toolbelt.Blazor.TimeZoneKit

Step.2 - Add calling UseLocalTimeZone() extension method in Main() method in your "Program.cs".

...
using Toolbelt.Blazor.Extensions.DependencyInjection; // <!-- Add this line, and..

public class Program
{
    public static async Task Main(string[] args)
    {
        var builder = WebAssemblyHostBuilder.CreateDefault(args);
        builder.RootComponents.Add<App>("app");
        ...
        await builder
            .Build()
            .UseLocalTimeZone() // <!-- Add this!
            .RunAsync();
        ...

That's all!

How does it work?

There is no magic.

This library contains all the system time zone information as a C# code.
(see: "TimeZoneKit.CreateSystemTimeZones.cs")

And, this library also contains mapping information for converting IANA time zone names to .NET time zone IDs.
(see: "TimeZoneKit.IANAtoTZIdMap.cs")

UseLocalTimeZone() extension method in this library invokes "Intl.DateTimeFormat().resolvedOptions().timeZone" JavaScript code to get the current time zone name (IANA name) on the web browser.

UseLocalTimeZone() extension method also set up the system time zone set and local time zone information by accessing undocumented / non public members in System.TimeZoneInfo class.

Note

  • WARNING - This library accesses private members of System.TimeZoneInfo using the "Reflection" .NET API, so it may break in future .NET runtime (mono.wasm) release.
  • In my test case, this package increased the size of the sample Blazor browser application content by 154 KB. (by 20KB gzip transfer.)

Release Note

  • v.7.0.0
    • BREAKING CHANGE: Support Blazor v.3.2.0 Preview 2 (not compatible with v.3.2.0 Preview 1 or before.)
  • v.6.0.0
    • BREAKING CHANGE: Support Blazor v.3.2.0 Preview 1 (not compatible with v.3.1.0 Preview 4 or before.)
    • Update time zone information
      • Morocco Standard Time
      • Fiji Standard Time
  • v.5.0.2
    • Update Central Brazilian Standard Time
    • Update E. South America Standard Time
  • v.5.0.1 - Update West Bank Standard Time
  • v.5.0.0 - BREAKING CHANGE: Support Blazor v.3.0.0 Preview 4 (not compatible with v.0.9.0 or before.)
  • v.4.0.0 - BREAKING CHANGE: Support Blazor v.0.9.0 (not compatible with v.0.8.0 or before.)
  • v.3.0.0 - BREAKING CHANGE: Support Blazor v.0.8.0 (not compatible with v.0.7.0 or before.)
  • v.2.1.0
    • Blazor v.0.6.0 support - it was signed strong name.
    • Update time zone information
      • Morocco Standard Time
      • Namibia Standard Time
      • Fiji Standard Time
  • v.2.0.0 - BREAKING CHANGE: Fix namespace of TimeZoneKitExtension class.
  • v.1.0.0 - 1st release.

License

Mozilla Public License Version 2.0