OpenTsdb官方文檔----日期和時間

??查詢數據時，OpenTSDB支持許多日期和時間格式。在通過GUI，CliQuery工具或HTTP API提交的查詢中支持以下格式。每個查詢都需要一個開始時間和一個可選結束時間。如果未指定結束時間，則將使用運行TSD的系統上的當前時間。

相對的

??如果您不知道要請求的確切時間戳，可以提交相對于TSD運行系統上的時間過去的時間。相對時間遵循以下格式<amount><time unit>-ago，其中<amount>為數值，<time unit>是指時間單位，如小時，天，等。例如，如果我們提供了一個起始時間1h-ago，并且leave結束時間，我們的查詢將返回在1小時前到當前時間的數據。可能的時間單位包括：

• ms - Milliseconds
• s - Seconds
• m - Minutes
• h - Hours
• d - Days (24 hours)
• w - Weeks (7 days)
• n - Months (30 days)
• y - Years (365 days)

注意：
??相對時間不包括閏秒，閏年或時區。他們只是計算當前時間過去的秒數。

絕對Unix時間

??在存儲內部，所有數據都與Unix（或POSIX）風格的時間戳相關聯。Unix時間定義為自1970年1月1日00:00:00 UTC時間起過去的秒數。時間戳被表示為一個正整數，例如1364410924，表示ISO 8601:2013-03-27T19:02:04Z。由于在OpenTSDB中存儲數據的調用需要Unix時間戳，因此在查詢中支持此格式是有意義的。因此，可以在查詢中為開始或結束時間的提供整數。

??使用Unix時間戳的查詢可以通過簡單追加三位數字來支持毫秒精度。例如，提供開始時間1364410924000和結束時間1364410924250將返回250毫秒窗口內數據。毫秒時間戳也可以提供一段時間，從毫秒中分隔秒數1364410924.250。任何具有13（或14）個字符的整數都將被視為毫秒時間戳。任何10個字符或更少的字符代表秒。毫秒只能以3位精度提供。如果您的工具輸出超過3位數字，則必須截斷或舍入該值。

絕對格式化時間

??由于在您的頭腦中計算Unix時間非常困難，OpenTSDB還支持人類可讀的絕對日期和時間。支持的格式包括：

• YYYY/ MM/ DD-HH:MM:SS
• yyyy/MM/dd HH:mm:ss
• YYYY/MM/ DD-HH:MM
• yyyy/MM/dd HH:mm
• YYYY/MM/DD
  ??yyyy代表年份為四位數值，例如2013。MM代表從01月份到12 月份。dd代表從月份開始的月份的一天01。HH代表在一天的24小時制出發的時間00到23。mm表示起始于分鐘00到59并ss表示秒開始00到59。所有月份，日，小時，分鐘和秒鐘都是單個數字，必須以0為前綴，例如每月的第5天必須為05。當沒有時間提供數據時，系統將假定給定日期的午夜。

??例子包括2013/01/23-12:50:42或2013/01/23。格式化的時間從運行TSD的主機的默認時區轉換為UTC。HTTP API查詢可以接受用戶提供的時區以覆蓋本地時區 。

??注意：
??使用CliQuery工具時，必須使用用短劃線將時間與日期分開的格式。這是因為命令行以空格為分割，所以如果在時間戳中放置空格，它將無法正確解析執行

時區

??在轉換人類可讀的時間戳時，OpenTSDB將根據TSD正在運行的系統上配置的時區轉換為UTC。盡管許多服務器都配置為UTC，但我們建議所有運行OpenTSDB的系統都使用UTC，但有時會使用本地時區。
??通過查詢字符串查詢HTTP API可以指定tz帶有時區標識字符串的參數，格式適用于運行TSD的系統的本地化設置。例如，我們可以指定tz=America/Los_Angeles將我們的時間戳從洛杉磯當地時間轉換為UTC。
??或者，如果無法更改系統時區，則可以通過配置文件tsd.core.timezone屬性提供覆蓋。

下一篇

OpenTsdb官方文檔----查詢過濾器