all_bills: All Bills in LegCo

In elgarteo/legco: R Bindings for the Hong Kong Legislative Council API

All Bills in LegCo

Description

Fetch the information of bills presented in LegCo since 1906.

Usage

all_bills(
  id = NULL,
  ordinance = NULL,
  title = NULL,
  proposer = NULL,
  gazette_from = "all",
  gazette_to = "all",
  first_from = "all",
  first_to = "all",
  second_from = "all",
  second_to = "all",
  third_from = "all",
  third_to = "all",
  n = 10000,
  extra_param = NULL,
  count = FALSE,
  verbose = TRUE
)

legco_all_bills(
  id = NULL,
  ordinance = NULL,
  title = NULL,
  proposer = NULL,
  gazette_from = "all",
  gazette_to = "all",
  first_from = "all",
  first_to = "all",
  second_from = "all",
  second_to = "all",
  third_from = "all",
  third_to = "all",
  n = 10000,
  extra_param = NULL,
  count = FALSE,
  verbose = TRUE
)

Arguments

id	the id of a bill, or a vector of ids. Defaults to NULL.
ordinance	the ordinance associated with the bill. Takes the full English name of the ordinance, e.g. "Buildings Ordinanace". Defaults to NULL.
title	the title of the bill. Takes the full English name of the bill, e.g. "National Anthem Bill". Defaults to NULL.
proposer	the proposer of the bill. Takes the full English title of the proposer, e.g. "Secretary for Security". Defaults to NULL.
gazette_from	only fetch bills gazetted on or after this date. Accepts "all", NULL or character values in "YYYY-MM-DD" format, and objects of class Date, POSIXt, POSIXct, POSIXlt or anything else that can be coerced to a date with as.Date(). If "all", returns all bills that have and have not been gazetted before being tabled in LegCo and overrides the gazette_to parameter. If NULL, returns bills that have not been gazetted before being tabled in LegCo (mainly older bills as newer ones required to be gazetted before tabling as required by the Rules of Procedure) and overrides the gazette_to parameter. Defaults to "all".
gazette_to	only fetch bills gazetted on or before this date. Accepts "all", NULL or character values in "YYYY-MM-DD" format, and objects of class Date, POSIXt, POSIXct, POSIXlt or anything else that can be coerced to a date with as.Date(). If "all", returns all bills that have and have not been gazetted before being tabled in LegCo and overrides the gazette_from parameter. If NULL, returns bills that have not been gazetted before being tabled in LegCo (mainly older bills as newer ones required to be gazetted before tabling as required by the Rules of Procedure) and overrides the gazette_from parameter. Defaults to "all".
first_from	only fetch bills that have gone through first reading on or after this date. Accepts "all", NULL or character values in "YYYY-MM-DD" format, and objects of class Date, POSIXt, POSIXct, POSIXlt or anything else that can be coerced to a date with as.Date(). If "all", returns all bills that have and have not gone through first reading and overrides the first_to parameter. If NULL, returns bills that have not gone through first reading and overrides the first_to parameter. Defaults to "all".
first_to	only fetch bills that have gone through first reading on or before this date. Accepts "all", NULL or character values in "YYYY-MM-DD" format, and objects of class Date, POSIXt, POSIXct, POSIXlt or anything else that can be coerced to a date with as.Date(). If "all", returns all bills that have and have not gone through first reading and overrides the first_from parameter. If NULL, returns bills that have not gone through first reading and overrides the first_from parameter. Defaults to "all".
second_from	only fetch bills that have gone through second reading on or after this date. Accepts "all", NULL or character values in "YYYY-MM-DD" format, and objects of class Date, POSIXt, POSIXct, POSIXlt or anything else that can be coerced to a date with as.Date(). If "all", returns all bills that have and have not gone through second reading and overrides the second_to parameter. If NULL, returns bills that have not gone through second reading and overrides the second_to parameter. Defaults to "all".
second_to	only fetch bills that have gone through second reading on or before this date. Accepts "all", NULL or character values in "YYYY-MM-DD" format, and objects of class Date, POSIXt, POSIXct, POSIXlt or anything else that can be coerced to a date with as.Date(). If "all", returns all bills that have and have not gone through second reading and overrides the second_from parameter. If NULL, returns bills that have not gone through second reading and overrides the second_from parameter. Defaults to "all".
third_from	only fetch bills that have gone through third reading on or after this date. Accepts "all", NULL or character values in "YYYY-MM-DD" format, and objects of class Date, POSIXt, POSIXct, POSIXlt or anything else that can be coerced to a date with as.Date(). If "all", returns all bills that have and have not gone through third reading and overrides the third_to parameter. If NULL, returns bills that have not gone through third reading and overrides the third_to parameter. Defaults to "all".
third_to	only fetch bills that have gone through third reading on or before this date. Accepts "all", NULL or character values in "YYYY-MM-DD" format, and objects of class Date, POSIXt, POSIXct, POSIXlt or anything else that can be coerced to a date with as.Date(). If "all", returns all bills that have and have not gone through third reading and overrides the third_from parameter. If NULL, returns bills that have not gone through third reading and overrides the third_from parameter. Defaults to "all".
n	the number of record to fetch. Defaults to 1000.
extra_param	additional query parameters defined in LegCo API. Must begin with "&".
count	logical: Whether to return only the total count of records that matches the parameter(s) instead of the result. Defaults to FALSE.
verbose	logical: Whether to display progress messages when fetching data? Defaults to TRUE.

Details

This function corresponds to the Vbills data endpoint of the Bills Database.

See Also

LegCo API documentation for the Meeting Schedule database: https://www.legco.gov.hk/en/open-legco/open-data/bills-database.html

Examples

# Fetch bills that passed third reading on February 20, 2019
x <- all_bills(third_from = "2019-02-20")

elgarteo/legco documentation built on Oct. 29, 2022, 10:11 p.m.