從 Google 財經服務擷取有價證券的最新或過往資訊。
用法示範
GOOGLEFINANCE("NASDAQ:GOOG", "price", DATE(2014,1,1), DATE(2014,12,31), "DAILY")
GOOGLEFINANCE("NASDAQ:GOOG","price",TODAY()-30,TODAY())
GOOGLEFINANCE(A2,A3)
語法
GOOGLEFINANCE(代號, [屬性], [開始日期], [結束日期|天數], [間隔])
-
代號- 要查詢的有價證券股票代號。必須同時使用交易所代號和股票代號來取得準確的結果，避免出現不一致。例如，請使用「NASDAQ:GOOG」，而不要使用「GOOG」。-
如果未指定交易所代號，
GOOGLEFINANCE將自行判斷適合的交易所。 -
注意：Reuters Instrument Codes 已不再受到支援。例如，您無法使用代號 123.TO 或 XYZ.AX，請改用 TSE:123 或 ASX:XYZ。
-
-
屬性- [選用 - 預設值是 "price"] - 要從 Google 財經服務擷取的代號相關屬性，如果指定了日期，則必須使用這個引數。-
屬性可以是下列任一項即時資料：-
"price"- 即時報價，最多延遲 20 分鐘。 -
"priceopen"- 股市開盤時的價格。 -
"high"- 今天的最高價。 -
"low"- 今天的最低價。 -
"volume"- 今天的股市交易量。 -
"marketcap"- 股票的市場價值。 -
"tradetime"- 最後成交時間。 -
"datadelay"- 即時資料延遲的時間。 -
"volumeavg"- 平均每日交易量。 -
"pe"- 每股價格/每股盈餘比例。 -
"eps"- 每一股的盈餘。 -
"high52"- 52 週期間的最高價。 -
"low52"- 52 週期間的最低價。 -
"change"- 自上一個交易日收盤以來的價格變化。 -
"beta"- 貝他值。 -
"changepct"- 自上一個交易日收盤以來的價格變化百分比。 -
"closeyest"- 前一天的收盤價。 -
"shares"- 在外流通的股數。 -
"currency"- 有價證券的計價貨幣單位。由於貨幣不存在交易期，所以使用這個引數將不會傳回開盤價、最低價、最高價和交易量。
-
-
屬性可以是下列任一項歷史資料：-
"open"- 指定日期的開盤價。 -
"close"- 指定日期的收盤價。 -
"high"- 指定日期的最高價。 -
"low"- 指定日期的最低價。 -
"volume"- 指定日期的成交量。 -
"all"- 以上所有歷史資料。
-
-
屬性可以是下列任一項共同基金資料：-
"closeyest"- 前一天的收盤價。 -
"date"- 所回報的基金淨值所屬日期。 -
"returnytd"- 年初至今報酬率。 -
"netassets"- 淨資產。 -
"change"- 最近回報基金淨值與上一筆基金淨值的變化。 -
"changepct"- 基金淨值的變化百分比。 -
"yieldpct"- 配息率、前 12 個月收入分配總額 (股息與固定收益利息) 以及基金淨值收益除以上個月的基金淨值。 -
"returnday"- 單日總計報酬率。 -
"return1"- 單週總計報酬率。 -
"return4"- 4 週總計報酬率。 -
"return13"- 13 週總計報酬率。 -
"return52"- 52 週 (1 年) 總計報酬率。 -
"return156"- 156 週 (3 年) 總計報酬率。 -
"return260"- 260 週 (5 年) 總計報酬率。 -
"incomedividend"- 最近的現金配息金額。 -
"incomedividenddate"- 最近的現金配息日期。 -
"capitalgain"- 最近的資本利得分配金額。 -
"morningstarrating"- 晨星的「星級」評比。 -
"expenseratio"- 基金的支出比率。
-
-
-
開始日期- [選用] - 擷取歷史資料的開始日期。- 如果您指定了
開始日期，但是沒有指定結束日期|天數，系統就只會傳回一天的資料。
- 如果您指定了
-
結束日期|天數- [選用] - 擷取歷史資料的結束日期，或是從開始日期算起要傳回幾天份的資料 (天數)。 -
間隔- [選用] - 資料的傳回頻率，可使用的值有「DAILY」和「WEEKLY」。間隔也可以用 1 或 7 的方式來指定，但不能使用其他數值。
附註
使用限制：這些資料不適用於金融業專業用途，也不適合其他非金融業公司 (包括政府機關) 的專業人士使用。第三方資料供應商可能會對專業用途收取額外授權費用。
-
所有參數都必須括在英文引號中，或是以內含文字的儲存格參照方式來指定。
注意：可能的例外狀況是，以數字形式指定「間隔」參數，或是以天數形式指定「結束日期|天數」參數時。 -
如果是即時資料，系統會在單一儲存格中傳回結果值。如果是歷史資料，就算只有一天，也會以展開的陣列形式呈現傳回值，並加上欄標題。
-
某些屬性可能無法傳回所有股票代號的資料。
- 如有指定任何日期參數，系統會將該要求視為歷史資料處理，並只允許使用歷史資料的屬性。
-
GOOGLEFINANCE只有英文版，並且不支援大部分國家/地區的證券交易資料。 -
您無法透過 Sheets API 或 Apps Script 下載或存取歷史資料。如果您嘗試這麼做，系統就會在您的試算表儲存格中顯示 #N/A 錯誤，而不是顯示相應的數值。
-
提供的報價並非來自所有市場的即時報價 (最長可能延遲 20 分鐘)。 所提供資訊均以現狀提供，僅供參考，不宜做為買賣依據或諮詢之用。
-
GOOGLEFINANCE中的日期是以 UTC 中午時間為準。在該時間點之前休市的交易所資料可能會偏移一天。
範例
注意：每個範例都位於單獨的分頁中。
一般使用情況
從 Google 財經服務擷取股市資訊。
常用屬性
股市歷史資料
從 Google 財經服務根據指定日期擷取歷史股市資訊。
共同基金
共同基金的常用屬性。
貨幣交易趨勢
利用 GoogleFinance 傳回的資料在儲存格中製作圖表，顯示過去 30 天內的貨幣交易趨勢。