numpy.busday_count

numpy.busday_count(begindates, enddates, weekmask='1111100', holidays=[], busdaycal=None, out=None)

計算 begindates 和 enddates 之間有效天數的數量，不包含 enddates 當天。

如果 enddates 指定的日期值早於對應的 begindates 日期值，則計數將為負數。

參數:

begindatesdatetime64[D] 的類陣列 (array_like)

用於計數的第一個日期陣列。

enddatesdatetime64[D] 的類陣列 (array_like)

用於計數的結束日期陣列，這些日期本身不包含在計數中。

weekmaskstr 或 bool 的類陣列 (array_like)，選用

一個七元素陣列，指示週一至週日哪些是有效天。可以指定為長度為七的列表或陣列，例如 [1,1,1,1,1,0,0]；長度為七的字串，例如 ‘1111100’；或類似 “Mon Tue Wed Thu Fri” 的字串，由工作日的三個字元縮寫組成，可選擇以空白分隔。有效縮寫為：Mon Tue Wed Thu Fri Sat Sun

holidaysdatetime64[D] 的類陣列 (array_like)，選用

要視為無效日期的日期陣列。它們可以以任何順序指定，並且會忽略 NaT（非時間）日期。此列表以標準化形式儲存，適用於快速計算有效天數。

busdaycalbusdaycalendar，選用

一個 busdaycalendar 物件，用於指定有效天數。如果提供了此參數，則不得提供 weekmask 或 holidays。

outint 陣列，選用

如果提供，此陣列將填入結果。

回傳值:

outint 陣列

一個陣列，其形狀來自一起廣播 (broadcasting) begindates 和 enddates，包含開始和結束日期之間有效天數的數量。

另請參閱

busdaycalendar

一個物件，用於指定自訂的有效天數集合。

is_busday

回傳一個布林陣列，指示有效天數。

busday_offset

套用以有效天數計算的偏移量。

範例

>>> import numpy as np
>>> # Number of weekdays in January 2011
... np.busday_count('2011-01', '2011-02')
21
>>> # Number of weekdays in 2011
>>> np.busday_count('2011', '2012')
260
>>> # Number of Saturdays in 2011
... np.busday_count('2011', '2012', weekmask='Sat')
53