從 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 天內的貨幣交易趨勢。