• background
• UI5
  • Get User Timezone
  • Add to OData parameters
  • 事务型 OData
• OData ABAP
  • ABAP Timestamp type
  • Convert to locale timestamp
• HANA
  • Table
  • HANA SQL
  • With Time Dimension
• 总结

本文主要介绍如何在SAP的系列软件中如何处理不同时区用户使用统一时间数据。

background

时区是指地球上使用同一个时间定义的区域。以前，人们通过观察太阳的位置（时角）决定时间，这就使得不同经度地方的时间有所不同（地方时）。1863年，首次使用时区的概念。时区通过设立一个区域的标准时间，部分地解决了这个问题。

作为一个国际性公司，当其在使用SAP软件时也会遇到不同时区的用户使用统一系统时间数据所带来的差异性问题。例如存储在SAP系统数据库中的业务数据时间是0时区时间，记一笔业务发生的时间是2016/09/26 20：00：00， 如果东8区的中国用户在查看系统时选择的时间范围是UTC+8 2016/09/27到2016/09/28，转换为0时区的时间应该是UTC+0 2016/09/26 16:00:00到2016/09/28 15：59：59，则这笔业务会被统计在UTC+8 2016/09/27这一天内。而如果是0时区英国用户查看则这笔会统计在2016/09/26。

本文介绍在SAP程序中如何处理这种情况。

UI5

如果要在 SAP UI5 界面做基于日期/月/年这种数据分析，我们可以使用类似下面的Analysis Table和Date Bar。

当用户选择如2016/09/17 - 2016/09/23时，这个日期是指用户所在时区的日期，在发送服务器请求前转换为UTC+0的timestamp，以便服务器统一处理时间。

Get User Timezone

UI获取当前时区的代码可以参考如下

function getUserTimezone() {
	var userTimsezone = "UTC+0000";
	var now = new Date();
	var offset = now.getTimezoneOffset() / 60;
	if(offset === 0){
	  userTimsezone = "UTC";
	}else{
	  var iMod = offset % 1;
	  var sMinutes = "";

	  if(Math.abs(iMod) === 0.5){
	    sMinutes = "3";
	  }

	  var iUserTimezone = - offset; //add minus to offset

	  //if user time zone is negative use the sign else add a plus
	  if(iUserTimezone < 0){
	    userTimsezone = "UTC" + parseInt(iUserTimezone) + sMinutes;
	  }else{
	    userTimsezone = "UTC+" + parseInt(iUserTimezone) + sMinutes;
	  }

	  if(userTimsezone === "UTC+1"){
	    userTimsezone = "CET";
	  }
	}
	return userTimsezone;
}

Add to OData parameters

UI5通过OData Model与后台交互，在OData请求参数里添加两个参数Timezone和Timestamp。

(Filter/Timezone eq ‘UTC+8’) and (Filter/Timestamp ge datetime’2016-09-16T16:00:00’ and Filter/Timestamp le datetime’2016-09-23T15:59:59’)

事务型 OData

如果要调用 OData 接口保存一个 DateTime 日期时间字段时要注意时区, 调用 OData 传过去的是时间戳, OData 不会考虑时区而直接存储在数据库中.

这样需要注意 SAPUI5 的 DatePicker 组件或者其他 JavaScript 选择或者创建的日期变量的时间戳是什么样的. 例如我们遇到 SAPUI5 DatePicker 组件默认选择的日期 Date 是

Fri Oct 16 2020 00:00:00 GMT+0800 (中国标准时间)

那么此时间看起来是 20201016 但是在传到后端时是时间戳, 时间戳是相对于 0 时区时间, 那么它存在数据库中会是 20201015, 所以再次读取出来后就是 20201015 了. 这其中的一个问题是存储时只考虑了日期而舍弃了时间, 造成了时间误差.

解决办法是修改 SAPUI5 DatePicker 组件属性 UTC: true 则组件选中日期则是以UTC+0的日期.

OData ABAP

ABAP Timestamp type

当ABAP服务端的OData收到请求时，前端UTC的timestamp时间戳会被转换成TIMESTAMPL类型。

ABAP提供两个built-in types和两个Dictionary types，如下表：

Convert to locale timestamp

ABAP收到的是timestamp in UTC+0和时区（e.g. UTC+8），需要把timestamp转换成locale的如2016-09-16T16:00:00 -> 2016-09-17T00:00:00

CONVERT TIME STAMP lv_ts_dummy TIME ZONE lv_timezone INTO DATE lv_date_dummy.

HANA

Table

假如 HANA 数据库有下面这个结构的数据表, 时间字段类型是 TIMESTAMPL， 要根据之前的选择日期进行统计每天销售总量。

• Sales_Order

HANA SQL

那么我们需要的SQL如下, TO_TIMESTAMP转换ABAP TIMESTAMP成UTC timestamp，UTCTOLOCAL转换UTC timestamp成Local日期时间，TO_DATS截取日期。

SELECT TO_DATS(UTCTOLOCAL(TO_TIMESTAMP(TIMESTAMP), 'UTC+8')) AS DATE_LOCAL,
		SUM(SALES) AS SALES
  FROM "Sales_Order"
  WHERE (TIMESTAMP BETWEEN '20160916160000.0000000'
           AND '20160923155959.0000000')
    GROUP BY TO_DATS(UTCTOLOCAL(TO_TIMESTAMP(TIMESTAMP), 'UTC+8'))

With Time Dimension

假如某一天没有业务数据，那上面的SQL就没有记录输出。前端UI需要在某天没有销售记录的情况下要输出数量为0的记录，我们可以修改SQL如下，增加M_TIME_DIMENSION的关联，M_TIME_DIMENSION是时间维度的全记录表。

SELECT
      A.DATE_LOCAL,
      A.SALES,
      B.DATE_SAP AS DATE
FROM "_SYS_BI"."M_TIME_DIMENSION" AS B
LEFT OUTER JOIN (
	SELECT TO_DATS(UTCTOLOCAL(TO_TIMESTAMP(TIMESTAMP), 'UTC+8')) AS DATE_LOCAL,
		SUM(SALES) AS SALES
  FROM "Sales_Order"
  WHERE (TIMESTAMP BETWEEN '20160916160000.0000000'
           AND '20160923155959.0000000')
    GROUP BY TO_DATS(UTCTOLOCAL(TO_TIMESTAMP(TIMESTAMP), 'UTC+8'))
    ) AS A ON A.DATE_LOCAL = B.DATE_SAP
WHERE B.DATETIME_SAP BETWEEN '20160917000000' AND '20160923000000'
GROUP BY B.DATE_SAP,
         A.DATE_LOCAL,
         A.SALES

总结

本文总结了不同时区用户查看SAP系统时，程序如何处理按时区时间统计数据。希望对读者能有所帮助。