ABP理论之时间

本篇目录

• 介绍
• Clock
• 时区
• 绑定器和转换器

  介绍

  虽然有些应用针对的是一个特定的时区，但是也有一些应用针对多个不同的时区。为了满足这些需求，ABP为datetime操作提供了通用的基础设施。

  Clock

  Clock是用于处理 DateTime类型的主要操作类。它定义了以下静态属性和方法：

  • Now：根据当前的provider获取当前的时间。
  • Kind：获取当前provider的DateTimeKind。
  • SupportsMultipleTimezone：获取一个值，该值表明当前的provider可以用于需要多个时区的应用程序。
  • Normalize：根据当前的provider标准化给定的DateTime。

  因此，我们可以使用Clock.Now代替DateTime.Now:DateTime now = Clock.Now;

  Clock使用了三种不同类型的内置clock providers：

  • ClockProviders.Unspecified：这是默认的clock provider。就像DateTime.Now一样，它会在你没有使用Clock类时奏效。
  • ClockProviders.Utc:以UTC时间工作。Clock.Now相当于DateTime.UtcNow ，Normalize方法会将一个给定的datetime转换成utc datetime，并将类别kind设置成DateTimeKind.UTC。它支持多时区。
  • ClockProviders.Local:以本地计算机时间工作。Normalize方法会将一个给定的datetime转换成一个本地 datetime，并将类别kind设置成DateTimeKind.Local。

  要使用不同的clock provider，需要设置Clock.Provider:Clock.Provider = ClockProviders.Utc;

  这通常是在应用开始的地方完成的，比如在一个web应用中是在Application_Start方法中完成的。

  客户端

  在客户端可以使用js代码 abp.clock对象来设置Clock。当在服务端设置了Clock.Provider时，ABP会自动在客户端设置abp.clock.provider的值

  时区

  ABP定义了一个名为Abp.Timing.TimeZone(TimingSettingNames.TimeZone常量)的设置存储租主、租户和用户选择的时区。ABP假设时区设置值时一个有效的Windows时区Id，也定义了一个将Windows时区转换成IANA时区的映射文件时区，因为一些公共类库还在使用IANA时区Id。要支持多时区，必须要使用 UtcClockProvider，因为如果使用了UtcClockProvider，那么所有的datetime值都会以utc存储，然后所有的datetime都会以UTC形式发送到客户端。接下来客户端就可以通过用户当前的时区设置将UTC时间设置为用户时区的时间。

  客户端

  ABP提供了一个叫做abp.timing.timeZoneInfo的js对象，它包含了当前用户的时区信息，该信息包含了Windows和IANA时区Id以及一些关于windows时区的其它信息。这些信息可以用于客户端的datetime转换。

  绑定器和转换器

  • ABP会基于当前的clock provider自动标准化从MVC、Web API和ASP.NET Core应用的客户端接收的DateTime值。
  • 当使用了EF或者NH模块时 ABP会基于当前的clock provider自动标准化从数据库接收的DateTime值。

  如果使用了UTC clock provider，那么存储在数据库中的所有DateTimes都认为是UTC值，从客户端接收的所有DateTimes都认为是UTC值。

• 
  

• 
  

• 
  

• 
  

• 本文转自tkbSimplest博客园博客，原文链接：http://www.cnblogs.com/farb/p/ABPTiming.html，如需转载请自行联系原作者