一說到時間，就會聯想到時區，夏令時等頭痛的問題，不同國家有不同國家的規定。如果你希望你的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:bf1cbc367561473db0c3fe762c11b508@thread.skype"},"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的時候就同時完成了授權。期待這天早點到來。
)
