Teams Bot如何判断用户所在的时区

一说到时间，就会联想到时区，夏令时等头痛的问题，不同国家有不同国家的规定。如果你希望你的Teams Bot可以判断出当前用户所在的时区，从而可以针对性的进行一些处理时，你要做好心理准备，这个复杂程度远远超过你的想象。因为一个用户这次在一个时区内登入Teams，下一次可能就在另一个时区了。

好消息是Teams已经帮我们做了很多事情，当Teams发送请求到我们的Bot时，payload里已经带了一些时间信息。我在我之前的一篇文章中也提到过。下面是一个标准的request body

{
    "name": "composeExtension/fetchTask",
    "type": "invoke",
    "timestamp": "2019-06-17T14:32:04.956Z",
    "localTimestamp": "2019-06-18T00:32:04.956+10:00",
    "id": "f:1361493733941541435",
    "channelId": "msteams",
    "serviceUrl": "https://smba.trafficmanager.net/apac/",
    "from": { },
    "conversation": {
        "isGroup": true,
        "conversationType": "channel",
        "tenantId": "aece5000-341d-493a-841d-f67e417f1447",
        "id": "19:[email protected]"
    },
    "recipient": { },
    "entities": [
        {
            "locale": "en-US",
            "country": "US",
            "platform": "Windows",
            "type": "clientInfo"
        }
    ],
    "channelData": { },
    "value": {
        "commandId": "start",
        "commandContext": "compose",
        "context": {
            "theme": "default"
        }
    },
    "locale": "en-US"
}

上面这个payload里有两个关键的时间信息：

• timestamp：当前的UTC时间
• localTimestamp：当前用户所在的他/她的本地时间，加号后面的小时数针对UTC时间的offset

所以你的bot就知道了这个用户当前所在的时区和UTC相差多少。要注意我有两个重要点：

• “当前”。 我前面已经提到过，用户的所在地会变化，Teams告诉bot的是此时此刻的用户信息
• “所在的时区和UTC相差多少”。这里说的并不是时区(timezone)，为什么这么说？我们举个例子：假设现在是UTC时间0点0分0秒，用户A在UTC+11的时区，那TA的时间是11:00am，另一个用户B在UTC+10时区，但TA所在国家正好在经历夏令时，所以B的时间也是11:00am。在这两种情况下，Teams对于用户A和用户B发送给Bot的时间信息是一样的。但是实际上他们在不同时区。

如果你看到这里有点晕了，请回到上面这段再看一遍。如果你看懂了，那你会问：到底有没有版本得到用户所在的时区？我的目前的答案是没有特别好的方法，但是Graph API有一个取巧的方法。

Graph API包含了Outlook api，我们使用下面这个api：

GET https://graph.microsoft.com/beta/users/{id|userPrincipalName}/mailboxSettings

我们看一下它返回什么内容

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('48d31887-5fad-4d73-a9f5-3c356e68a038')/mailboxSettings",
  "archiveFolder": "AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OAAuAAAAAAAiQ8W967B7TKBjgx9rVEURAQAiIsqMbYjsT5e-T7KzowPTAAAAAAFNAAA=",
  "timeZone": "Pacific Standard Time",
  "dateFormat": "M/d/yyyy",
  "timeFormat": "h:mm tt",
  "automaticRepliesSetting": {
    "status": "disabled",
    "externalAudience": "all",
    "internalReplyMessage": "",
    "externalReplyMessage": "",
    "scheduledStartDateTime": {
      "dateTime": "2019-10-05T12:00:00.0000000",
      "timeZone": "UTC"
    },
    "scheduledEndDateTime": {
      "dateTime": "2019-10-06T12:00:00.0000000",
      "timeZone": "UTC"
    }
  },
  "language": {
    "locale": "en-US",
    "displayName": "English (United States)"
  },
  "workingHours": {
    "daysOfWeek": [
      "monday",
      "tuesday",
      "wednesday",
      "thursday",
      "friday"
    ],
    "startTime": "08:00:00.0000000",
    "endTime": "17:00:00.0000000",
    "timeZone": {
      "name": "Pacific Standard Time"
    }
  }
}

是不是很强大？不旦旦有timezone信息，还有日期时间显示格式的偏好。还有工作日信息，不同国家对工作日的定义是不同的。还有标准工作时间的信息，不同公司对上下班时间的设置也会不同。

当然，使用Graph API并不是没有代价的，这个需要用户做额外的授权，不过Teams产品团队表示，以后会把对Graph API的授权和Teams app合在一起，这样用户在安装teams app的时候就同时完成了授权。期待这天早点到来。