get_bills: The Records of the Bills: 法律提案

In yl17124/legisTaiwan: An Interface to Access Taiwan Legislative API in R

The Records of the Bills: 法律提案

Description

The Records of the Bills: 法律提案

Usage

get_bills(start_date = NULL, end_date = NULL, proposer = NULL, verbose = TRUE)

Arguments

start_date	numeric. Must be formatted in the ROC Taiwan calendar, e.g., 1090101.
end_date	numeric. Must be formatted in the ROC Taiwan calendar, e.g., 1090102.
proposer	The default value is NULL, indicating that bills proposed by all legislators are included between the start and end dates.
verbose	logical. Specifies whether get_bills should print out detailed output when retrieving the data. The default value is TRUE.

Details

The get_bills function returns a list that contains query_time, retrieved_number, meeting_unit, start_date_ad, end_date_ad, start_date, end_date, url, variable_names, manual_info, and data.

Value

A list, which contains:

title

Records of cross-caucus sessions

query_time

Query timestamp

retrieved_number

Number of observations retrieved

meeting_unit

Meeting unit

start_date_ad

Start date in POSIXct format

end_date_ad

End date in POSIXct format

start_date

Start date in the ROC Taiwan calendar

url

URL of the retrieved JSON data

variable_names

Variable names of the tibble dataframe

manual_info

Official manual. See https://www.ly.gov.tw/Pages/List.aspx?nodeid=153 or use get_variable_info("get_bills")

data

A tibble dataframe with the following variables:

term

Session number

sessionPeriod

Session period

sessionTimes

Session count

meetingTimes

Proposal date

billName

Bill name

billProposer

Primary proposer

billCosignatory

Co-signatories of the bill

billStatus

Status of the bill

date_ad

Date in the Gregorian calendar

Note

To retrieve the user manual and more details about the data frame, use get_variable_info("get_bills"). Further checks are required as the user manual seems to be inconsistent with the actual data.

Author(s)

David Liao ([e-mail])

See Also

https://www.ly.gov.tw/Pages/List.aspx?nodeid=153

Examples

## Not run: 
## Query bill records by a date range in the Taiwan ROC calendar format
get_bills(start_date = 1060120, end_date = 1070310, verbose = TRUE)

## Query bill records by a date range and a specific legislator
get_bills(start_date = 1060120, end_date = 1070310,  proposer = "孔文吉")

## Query bill records by a date range and multiple legislators
get_bills(start_date = 1060120, end_date = 1060510,  proposer = "孔文吉&鄭天財")

## End(Not run)

yl17124/legisTaiwan documentation built on Jan. 22, 2025, 8:47 p.m.