With numeric values in a gt table, we can perform percentagebased
formatting. It is assumed the input numeric values are in a fractional format
since the numbers will be automatically multiplied by 100
before
decorating with a percent sign. For more control over percentage formatting,
we can use the following options:
percent sign placement: the percent sign can be placed after or before the values and a space can be inserted between the symbol and the value.
decimals: choice of the number of decimal places, option to drop trailing zeros, and a choice of the decimal symbol
negative values: choice of a negative sign or parentheses for values less than zero
digit grouping separators: options to enable/disable digit separators and provide a choice of separator symbol
pattern: option to use a text pattern for decoration of the formatted values
localebased formatting: providing a locale ID will result in number formatting specific to the chosen locale
fmt_percent(data, columns, rows = NULL, decimals = 2, drop_trailing_zeros = FALSE, negative_val = "signed", use_seps = TRUE, pattern = "{x}", sep_mark = ",", dec_mark = ".", incl_space = FALSE, placement = "right", locale = NULL)
data  a table object that is created using the 

columns  the columns to format. Can either be a series of column names
provided in 
rows  optional rows to format. Not providing any value results in all
rows in 
decimals  an option to specify the exact number of decimal places to
use. The default number of decimal places is 
drop_trailing_zeros  a logical value that allows for removal of trailing zeros (those redundant zeros after the decimal mark). 
negative_val  the formatting to use for negative values. With

use_seps  an option to use digit group separators. The type of digit
group separator is set by 
pattern  a formatting pattern that allows for decoration of the
formatted value. The value itself is represented by 
sep_mark  the mark to use as a separator between groups of digits
(e.g., using 
dec_mark  the character to use as a decimal mark (e.g., using

incl_space  an option on whether to include a space between the value and the percent sign. The default is to not introduce a space character. 
placement  the placement of the percent sign. This can be either be

locale  an optional locale ID that can be used for formatting the value
according the locale's rules. Examples include 
an object of class gt_tbl
.
Targeting of values is done through columns
and additionally by
rows
(if nothing is provided for rows
then entire columns are
selected). A number of helper functions exist to make targeting more
effective. Conditional formatting is possible by providing a conditional
expression to the rows
argument. See the Arguments section for more
information on this.
Other data formatting functions: data_color
,
fmt_currency
, fmt_datetime
,
fmt_date
, fmt_markdown
,
fmt_missing
, fmt_number
,
fmt_passthrough
,
fmt_scientific
, fmt_time
,
fmt
, text_transform