Package {serad}

Title:	Standardized Economic Reporting and Automated Dynamic Writing / Synthèse d'Écrits Avec des Règles Automatisées et Dynamiques
Version:	0.2.0
Description:	Provides tools for generating dynamic and standardized economic narratives in R Markdown documents. The package is primarily designed for French-language statistical and economic publications. It includes functions to describe changes in levels, percentages, trends, accelerations and short-term economic developments using consistent linguistic rules. The package supports automated reporting workflows and reproducible economic writing. Fournit des outils permettant de générer des textes économiques dynamiques et standardisés dans des documents R Markdown. Le package est principalement conçu pour les publications statistiques et économiques en français. Il propose des fonctions permettant de décrire les évolutions de niveaux, de pourcentages, de tendances, d'accélérations et les évolutions conjoncturelles à l'aide de règles linguistiques homogènes. Le package facilite l'automatisation de la rédaction et la reproductibilité des publications économiques.
License:	MIT + file LICENSE
Encoding:	UTF-8
RoxygenNote:	7.3.3
Imports:	utils, tibble
Suggests:	knitr, rmarkdown, testthat (≥ 3.0.0)
VignetteBuilder:	knitr
Config/testthat/edition:	3
NeedsCompilation:	no
Packaged:	2026-05-29 14:33:43 UTC; X6QOAN
Author:	Alexandre Cazenave-Lacroutz [aut], Jules Lejas [cre], Direction de l'animation de la recherche, des études et des statistiques (Dares) [cph]
Maintainer:	Jules Lejas <jules.lejas@gmail.com>
Repository:	CRAN
Date/Publication:	2026-06-02 11:00:02 UTC

Calcul d'une accélération

Description

Calcule l'accélération entre trois niveaux successifs en comparant les taux de variation consécutifs.

Usage

a(x1, x2, x3)

Arguments

Details

L'accélération correspond à la variation du taux entre (x1, x2) et (x2, x3).

Value

Un nombre numérique correspondant à l'accélération en pourcentage.

See Also

g, format_g

Examples

a(4, 2, 1)  # 0
a(6, 2, 1)  # 100
a(2, 1, 1)  # valeur très élevée si taux précédent proche de zéro

Évolution à la hausse, à la baisse ou inchangée

Description

Indique si x1 évolue à la hausse, à la baisse ou reste inchangé par rapport à x2.

Usage

alahausse(x1, x2, seuil = 0.1, lang = get_serad_language())

Arguments

Value

Une chaîne de caractères.

See Also

comparaison

Arrondi arithmétique

Description

Arrondit un nombre selon la règle arithmétique (0.5 vers le haut), contrairement à round() qui utilise l'arrondi bancaire.

Usage

arrondi_tot(x, digits = 1)

Arguments

Value

Un nombre numérique arrondi.

See Also

format_niv

Examples

arrondi_tot(1877.85, digits = 0)   # 1878
arrondi_tot(1877.85, digits = 1)   # 1877.9
arrondi_tot(1877.85, digits = -1)  # 1880

Position relative entre deux niveaux

Description

Indique si x1 est au-dessus ou en dessous de x2.

Usage

audessus(x1, x2, lang = get_serad_language())

Arguments

Value

Une chaîne de caractères.

See Also

comparaison

Comparaison qualitative entre deux niveaux

Description

Compare deux niveaux successifs et retourne une formulation selon l'évolution observée.

Usage

comparaison(
  x1,
  x2,
  hausse_defaut,
  egalite_defaut,
  baisse_defaut,
  seuil = 0.1,
  alt = 0,
  hausse_alt = hausse_defaut,
  egalite_alt = egalite_defaut,
  baisse_alt = baisse_defaut
)

Arguments

Details

La comparaison repose sur le taux de variation calculé via g. Des cas particuliers sont traités lorsque x2 est nul ou négatif.

Value

Une chaîne de caractères correspondant à la formulation retenue.

See Also

comparaison_taux, g

Examples

comparaison(1.04, 1, "augmente", "reste stable", "diminue")
comparaison(0.9991, 1, "augmente", "reste stable", "diminue")
comparaison(1, 1, "augmente", "reste égal", "diminue", seuil = 0)

Comparaison d'une variation à un seuil

Description

Comparaison d'une variation à un seuil

Usage

comparaison_taux(
  g,
  hausse_defaut,
  egalite_defaut,
  baisse_defaut,
  seuil = 0.1,
  alt = 0,
  hausse_alt = hausse_defaut,
  egalite_alt = egalite_defaut,
  baisse_alt = baisse_defaut
)

Arguments

Details

Fonction interne utilisée par comparaison.

Value

Une chaîne de caractères correspondant à la modalité choisie.

See Also

comparaison

Examples

comparaison_taux(5, "augmente", "reste stable", "diminue")
comparaison_taux(0.05, "augmente", "reste stable", "diminue")
comparaison_taux(0, "as", "bs", "cs", seuil = 0, alt = 1,
                 hausse_alt = "a", egalite_alt = "b", baisse_alt = "c")

Documente les contributions à une évolution

Description

Un dataframe en entrée.
Si non indiqué, la date est considérée comme étant la première colonne. Pas besoin de la formater.
Si non indiqué, on suppose les valeurs les plus anciennes en haut (temps croissant).
Toutes les autres colonnes sont considérées comme les composantes dont les contributions doivent être analysées. Elles doivent être numériques.

Usage

contributions(
  df,
  temps = "croissant",
  vart,
  Tglissement = 1,
  seuilpc = 20,
  lang = get_serad_language()
)

Arguments

Details

Fonction écrite sur demande d'une utilisatrice.

Si aucune contribution n'est supérieure à seuilpc en valeur absolue, contributions() retourne a minima la plus grande contribution de même sens que la contribution totale.

Value

Un descriptif ordonné des différentes glissements.

Examples

col0 = c("Y1T1", "Y1T2", "Y1trim3", "Y1T4","Y2T1","Y2-T2")
col1 = c( 12,      6,      2,         86,     19,     10)
col2 = c(  4,      8,      7,         34,     87,     14)
col3 = c( 10,     20,      3,         66,     90,     54)
col4 = c( 29,     12,      4,         16,     40,     94)
col5 = c( 58,     76,      1,          3,     34,     19)
df1 = data.frame(col0,col1,col2,col3,col4,col5)

contributions(df1)

Davantage ou moins

Description

Indique si x1 est davantage ou moins élevé que x2.

Usage

davantage(x1, x2, lang = get_serad_language())

Arguments

Value

Une chaîne de caractères.

See Also

comparaison

Verbe pour exprimer le sens de l'évolution

Description

Indique si x1 excède, est au niveau de ou est en dessous de x2, en tenant compte du nombre grammatical.

Usage

depasse(x1, x2, sing = FALSE, lang = get_serad_language())

Arguments

Value

Une chaîne de caractères.

See Also

comparaison

Formatage des variations en niveau

Description

Formate une différence numérique selon les règles d'arrondi et d'affichage utilisées dans le package.

Usage

format_delta(
  y,
  signe = TRUE,
  detail = getOption("serad")$arrondi_niv,
  lang = get_serad_language()
)

Arguments

Value

Une chaîne de caractères correspondant à la variation formatée.

See Also

arrondi_tot, format_niv

Examples

format_delta(365484)              # "+365 500"
format_delta(365484, FALSE)       # "365 500"
format_delta(-365484)             # "-365 500"
format_delta(-365484, FALSE)      # "365 500"
format_delta(365484, lang = "en") # "+365,500"

Formatage des variations en pourcentage

Description

Formate une variation exprimée en pourcentage selon les règles d'arrondi et d'affichage du package.

Usage

format_g(
  y,
  signe = TRUE,
  detail = getOption("serad")$arrondi_pourcent,
  lang = get_serad_language()
)

Arguments

Details

Le symbole "moins" peut être personnalisé via getOption("serad")$moins.

Value

Une chaîne de caractères correspondant à la variation formatée (ex. "+5,4%", "-5,4%", "+5.4%").

See Also

g, arrondi_tot

Examples

format_g(5.3654, signe = FALSE)           # "5,4 %"
format_g(5.3654)                          # "+5,4 %"
format_g(-5.3654, FALSE)                  # "5,4 %"
format_g(-5.3654)                         # "-5,4 %"
format_g(-5.3654, detail = 2)             # "-5,37 %"
format_g(0.35)                            # "+0,4 %"
format_g(5.3654, lang = "en")             # "+5.4%"

Formatage des niveaux en nombres

Description

Formate un niveau numérique selon les règles d'arrondi définies dans le package.

Usage

format_niv(
  y,
  detail = getOption("serad")$arrondi_niv,
  lang = get_serad_language()
)

Arguments

Value

Une chaîne de caractères correspondant au niveau formaté.

See Also

arrondi_tot

Examples

format_niv(365484)                # "365 500"
format_niv(365484, lang = "en")   # "365,500"

Formatage des variations en points

Description

Formate une variation exprimée en points selon les règles d'arrondi et d'affichage du package.

Usage

format_pts(
  y,
  signe = TRUE,
  detail = getOption("serad")$arrondi_pourcent,
  abrev = FALSE,
  lang = get_serad_language()
)

Arguments

Details

Le symbole "moins" peut être personnalisé via getOption("serad")$moins.

Value

Une chaîne de caractères correspondant à la variation formatée (ex. "+5,4 points", "+5.4 points").

See Also

format_g

Examples

format_pts(5.3654, signe = FALSE)   # "5,4 points"
format_pts(1.3654, signe = FALSE)   # "1,4 point"
format_pts(5.3654, abrev = TRUE)    # "+5,4 pts"
format_pts(-5.3654, FALSE)          # "5,4 points"
format_pts(-5.3654)                 # "-5,4 points"
format_pts(-5.3654, detail = 2)     # "-5,37 points"
format_pts(0.35)                    # "+0,4 points"

Calcul d'une variation relative

Description

Calcule la variation relative entre x1 et x2, exprimée en pourcentage.

Usage

g(x1, x2, eps = 1e-08)

Arguments

Details

Si x2 = 0, la valeur epsilon définie par getOption("serad")$eps est utilisée afin d'éviter une division par zéro. Un message d'avertissement est émis dans ce cas.

Il est possible de modifier cette valeur :

serad0 <- getOption("serad") serad0$eps <- 0 options(serad = serad0)

Value

Une valeur numérique correspondant à la variation en pourcentage (par exemple, si x1 = 2 * x2, la fonction retourne 100).

See Also

format_g

Examples

g(2, 1)  # 100
g(2, 0)  # valeur très élevée et avertissement

Évolution nominale tenant compte de l'accélération

Description

Décrit l'évolution sous forme nominale à partir de trois niveaux, en tenant compte de l'accélération entre deux variations successives.

Usage

gETa_nom(x1, x2, x3, titre = FALSE, alea = 0, lang = get_serad_language())

Arguments

Details

La fonction calcule d'abord deux évolutions successives : g1 <- serad::g(x1, x2) et g2 <- serad::g(x2, x3).

Ces deux variations sont ensuite transmises à gETa_nom_taux, qui calcule leur accélération à l'aide de a et détermine la formulation nominale appropriée à partir de la table getOption("serad")$evo_accel.

Une formulation alternative peut être utilisée via la table getOption("serad")$evo_accel_alt. Le choix entre la formulation principale et la variante dépend du paramètre alea.

Value

Une chaîne de caractères correspondant à la formulation nominale retenue.

Personnalisation

Les formulations utilisées par cette fonction proviennent des tables getOption("serad")$evo_accel et getOption("serad")$evo_accel_alt.

Pour modifier les seuils, les conditions ou les libellés, voir init_serad.

See Also

gETa_nom_taux, g, a, init_serad

Examples

gETa_nom(1.00049, 1, 0.9996)
gETa_nom(1.1, 1, 0.99)
gETa_nom(1.003, 1, 0.99)
gETa_nom(0.96, 1, 1.01)
gETa_nom(0.8, 1, 0.99)
gETa_nom(1.1, 1, 0.99, alea = 0.5)

Évolution nominale tenant compte de l'accélération

Description

Décrit l'évolution sous forme nominale en tenant compte de l'accélération entre deux variations successives.

Usage

gETa_nom_taux(g1, g2, titre = FALSE, alea = 0, lang = get_serad_language())

Arguments

Details

La fonction calcule d'abord l'accélération entre g1 et g2 à l'aide de a.

Elle parcourt ensuite la table getOption("serad")$evo_accel ligne par ligne. Chaque ligne contient un ensemble de conditions sur g1, g2 et l'accélération. La première ligne dont toutes les conditions sont vérifiées détermine la formulation retenue.

Une formulation alternative peut être utilisée via la table getOption("serad")$evo_accel_alt, qui contient une variante pour chaque ligne de evo_accel. Le choix entre la formulation principale et la variante dépend du paramètre alea.

Si titre = TRUE, l'article initial est supprimé et la première lettre restante est mise en majuscule.

Value

Une chaîne de caractères correspondant à la formulation nominale retenue (par exemple : "une accélération", "une stabilisation").

Personnalisation

Les formulations utilisées par cette fonction proviennent des tables getOption("serad")$evo_accel et getOption("serad")$evo_accel_alt.

Pour modifier les seuils, les conditions ou les libellés, voir init_serad.

See Also

a, gETa_verbe_taux, init_serad

Examples

gETa_nom_taux(0.049, 0.049)
gETa_nom_taux(10, 1)
gETa_nom_taux(-4, 1, titre = TRUE)
gETa_nom_taux(-21, 1)
gETa_nom_taux(10, 1, alea = 0.5)

Évolution verbale tenant compte de l'accélération

Description

Décrit l'évolution sous forme verbale à partir de trois niveaux, en tenant compte de l'accélération entre deux variations successives.

Usage

gETa_verbe(x1, x2, x3, sing = TRUE, alea = 0, lang = get_serad_language())

Arguments

Details

La fonction calcule d'abord deux évolutions successives : g1 <- serad::g(x1, x2) et g2 <- serad::g(x2, x3).

Ces deux variations sont ensuite transmises à gETa_verbe_taux, qui calcule leur accélération à l'aide de g et détermine la formulation verbale appropriée à partir de la table getOption("serad")$evo_accel.

Une formulation alternative peut être utilisée via la table getOption("serad")$evo_accel_alt. Le choix entre la formulation principale et la variante dépend du paramètre alea.

Value

Une chaîne de caractères correspondant à la formulation verbale retenue.

Personnalisation

Les formulations utilisées par cette fonction proviennent des tables getOption("serad")$evo_accel et getOption("serad")$evo_accel_alt.

Pour modifier les seuils, les conditions ou les libellés, voir init_serad.

See Also

gETa_verbe_taux, g, init_serad

Examples

gETa_verbe(1.00049, 1, 0.9996)
gETa_verbe(1.1, 1, 0.99)
gETa_verbe(1.003, 1, 0.99, sing = FALSE)
gETa_verbe(0.96, 1, 1.01)
gETa_verbe(1.1, 1, 0.99, alea = 0.5)

Évolution verbale tenant compte de l'accélération

Description

Décrit l'évolution sous forme verbale en tenant compte de l'accélération entre deux variations successives.

Usage

gETa_verbe_taux(g1, g2, sing = TRUE, alea = 0, lang = get_serad_language())

Arguments

Details

La fonction calcule d'abord l'accélération entre g1 et g2 à l'aide de a.

Elle parcourt ensuite la table getOption("serad")$evo_accel ligne par ligne. Chaque ligne contient un ensemble de conditions sur g1, g2 et l'accélération. La première ligne pour laquelle toutes les conditions sont vérifiées détermine la formulation retenue.

Une formulation alternative peut être utilisée via la table getOption("serad")$evo_accel_alt. Le choix entre la formulation principale et la variante dépend du paramètre alea.

Si sing = TRUE, la fonction renvoie la colonne verbe_sing. Sinon, elle renvoie verbe_plur.

Value

Une chaîne de caractères correspondant à la formulation verbale retenue (par exemple : "accélère", "se stabilise").

Personnalisation

Les formulations utilisées par cette fonction proviennent des tables getOption("serad")$evo_accel et getOption("serad")$evo_accel_alt.

Pour modifier les seuils, les conditions ou les libellés, voir init_serad.

See Also

a, gETa_nom_taux, init_serad

Examples

gETa_verbe_taux(0.049, 0.049)
gETa_verbe_taux(10, 1)
gETa_verbe_taux(4, 1, FALSE)
gETa_verbe_taux(-4, 1)
gETa_verbe_taux(-21, 1)
gETa_verbe_taux(10, 1, alea = 0.5)

Évolution nominale non suivie d'une valeur

Description

Décrit une évolution sous forme nominale à partir de deux niveaux, sans ajouter la valeur de variation.

Usage

g_nom(
  x1,
  x2,
  evolution = c("pourcents", "points"),
  titre = FALSE,
  lang = get_serad_language()
)

Arguments

Details

La fonction calcule d'abord une évolution à partir de x1 et x2 :

• si evolution = "pourcents", elle utilise g ;

• si evolution = "points", elle calcule x1 - x2.

La valeur obtenue est ensuite transmise à g_nom_taux, qui détermine la formulation à partir de la table getOption("serad")$evo_simple.

Value

Une chaîne de caractères correspondant à la formulation nominale retenue (par exemple : "une forte hausse").

Personnalisation

Les formulations utilisées par cette fonction proviennent de la table getOption("serad")$evo_simple.

Pour modifier les seuils ou les libellés, voir init_serad.

See Also

g_nom_taux, g, init_serad

Examples

g_nom(1.04, 1)
g_nom(1.01, 1)
g_nom(1.004, 1)
g_nom(1.001, 1)
g_nom(1, 1)
g_nom(0.997, 1)
g_nom(0.95, 1)
g_nom(0.95, 1, evolution = "points")

Évolution nominale simple

Description

Décrit l'évolution entre x1 et x2 sous forme nominale suivie du pourcentage correspondant.

Usage

g_nom_simple(x1, x2, lang = get_serad_language())

Arguments

Value

Une chaîne de caractères.

Évolution nominale d'un taux

Description

Décrit une évolution exprimée en pourcentage sous forme nominale (par exemple : "une forte hausse").

Usage

g_nom_taux(g, titre = FALSE, lang = get_serad_language())

Arguments

Details

La fonction sélectionne, dans la table getOption("serad")$evo_simple, la première ligne dont le seuil est strictement inférieur à g.

Elle renvoie ensuite la colonne nom correspondante. Si titre = TRUE, l'article initial est supprimé et la première lettre restante est mise en majuscule.

Value

Une chaîne de caractères décrivant l'évolution (par exemple : "une forte hausse", "une stabilité").

Personnalisation

Les formulations utilisées par cette fonction proviennent de la table getOption("serad")$evo_simple.

Pour modifier les seuils ou les libellés, voir init_serad.

See Also

g_verbe_taux, init_serad

Examples

g_nom_taux(4)
g_nom_taux(1)
g_nom_taux(0.4)
g_nom_taux(0.1)
g_nom_taux(0)
g_nom_taux(-0.3)
g_nom_taux(-1)
g_nom_taux(-4)
g_nom_taux(-5)

Évolution verbale ne tenant pas compte de l'accélération et suivie de la valeur

Description

Décrit une évolution sous forme verbale à partir de deux niveaux, sans tenir compte d'une éventuelle accélération, et en ajoutant la valeur de variation.

Usage

g_verbe(
  x1,
  x2,
  sing = TRUE,
  evolution = c("pourcents", "points"),
  stable_sans_valeur = TRUE,
  lang = get_serad_language()
)

Arguments

Details

La fonction calcule d'abord une évolution à partir de x1 et x2 :

• si evolution = "pourcents", elle utilise g ;

• si evolution = "points", elle calcule x1 - x2.

La valeur obtenue est ensuite transmise à g_verbe_taux, qui détermine la formulation à partir de la table getOption("serad")$evo_simple.

Value

Une chaîne de caractères correspondant à la formulation verbale retenue, par exemple : "bondit de 10,0 %".

Personnalisation

Les formulations utilisées par cette fonction proviennent de la table getOption("serad")$evo_simple.

Pour modifier les seuils ou les libellés, voir init_serad.

See Also

g_verbe_taux, g, init_serad

Examples

g_verbe(1.1, 1)
g_verbe(1.04, 1)
g_verbe(1.01, 1, sing = FALSE)
g_verbe(1.003, 1)
g_verbe(0.999, 1)
g_verbe(0.999, 1, stable_sans_valeur = FALSE)
g_verbe(0.96, 1)
g_verbe(0.79, 1)

Évolution verbale d'un taux

Description

Décrit une évolution sous forme verbale, sans tenir compte d'une éventuelle accélération, et suivie de la valeur formatée.

Usage

g_verbe_taux(
  g,
  sing = TRUE,
  evolution = c("pourcents", "points"),
  stable_sans_valeur = TRUE,
  lang = get_serad_language()
)

Arguments

Details

La fonction sélectionne, dans la table getOption("serad")$evo_simple, la première ligne dont le seuil est strictement inférieur à g.

Si sing = TRUE, la fonction renvoie la colonne verbe_sing. Sinon, elle renvoie verbe_plur.

Value

Une chaîne de caractères décrivant l'évolution.

Personnalisation

Les formulations utilisées par cette fonction proviennent de la table getOption("serad")$evo_simple.

Pour modifier les seuils ou les libellés, voir init_serad.

See Also

g_verbe, format_g, format_pts, init_serad

Examples

g_verbe_taux(10)
g_verbe_taux(-0.1)

Récupère la langue de serad

Description

Retourne la langue actuellement utilisée par {serad}.

Usage

get_serad_language()

Value

Une chaîne de caractères indiquant la langue courante ("fr" ou "en").

Initialisation des règles de rédaction de {serad}

Description

Les fonctions init_serad_fr() et init_serad_en() définissent l'ensemble des règles utilisées par {serad} pour produire des textes de conjoncture.

Elles initialisent notamment :

• les règles d'arrondi ;

• le symbole de signe négatif ;

• les seuils d'évolution ;

• les tables de correspondance entre évolutions et formulations ;

• les règles de gestion de l'accélération.

Usage

init_serad_en()

init_serad_fr()

Details

Les principales structures utilisées sont :

• evo_simple : utilisée pour les évolutions simples (g_nom_taux, g_verbe_taux) ;

• evo_accel : utilisée pour les évolutions tenant compte de l'accélération (gETa_nom_taux, gETa_verbe_taux) ;

• evo_accel_alt : variantes utilisées lorsque l'argument alea est activé.

Value

Pas de valeur de retour, appelée pour ses effets de bord.

Personnalisation

La méthode recommandée pour personnaliser les règles de rédaction consiste à copier le contenu de init_serad_fr() ou init_serad_en() dans un script utilisateur, puis à modifier directement les tables et les seuils.

Exemple :

# Copier le contenu de init_serad_fr()

serad0 <- list()

serad0$evo_simple <- tibble::tribble(
  ~seuil, ~verbe_sing, ~verbe_plur, ~nom,
  1, "augmente", "augmentent", "une hausse",
  0, "est stable", "sont stables", "une stabilité",
  -Inf, "diminue", "diminuent", "une baisse"
)

options(serad = serad0)

Cette approche permet :

• une personnalisation complète des formulations ;

• une adaptation aux conventions métier ;

• une reproductibilité via un script versionné.

See Also

g_nom_taux, g_verbe_taux, gETa_nom_taux, gETa_verbe_taux

Fournit dynamiquement le mois suivant

Description

Retourne la formulation du mois situé à k périodes après le mois indiqué.

Usage

nextMois(
  mois,
  annee,
  type = c("Annee", "autres"),
  majuscule = FALSE,
  k = 1,
  lang = get_serad_language()
)

Arguments

Value

Une chaîne de caractères correspondant au mois suivant.

See Also

quelMois, prevMois, nextTrim

Examples

nextMois(3, 2023)
nextMois(12, 2023)
nextMois(12, 2023, k = 2)

Fournit dynamiquement le trimestre suivant

Description

Retourne la formulation du trimestre situé à k périodes après le trimestre indiqué.

Usage

nextTrim(
  trim,
  annee,
  type = c("lettres", "chiffres"),
  majuscule = FALSE,
  exposant = TRUE,
  k = 1,
  lang = get_serad_language()
)

Arguments

Value

Une chaîne de caractères correspondant au trimestre suivant.

See Also

quelTrim, prevTrim

Examples

nextTrim(3, 2023)
nextTrim(4, 2023)

Indique si le niveau est le plus haut ou le plus bas de la série

Description

Détermine si la dernière valeur d'une série correspond au plus haut ou au plus bas niveau observé depuis un certain nombre de périodes.

Usage

plushautniveau(
  df,
  temps = "croissant",
  voc_haut,
  voc_bas,
  vart,
  vary,
  nbperiode = 3,
  lang = get_serad_language()
)

Arguments

Value

Une chaîne de caractères indiquant le plus haut ou le plus bas niveau depuis une date donnée. Retourne une chaîne vide si rien de notable.

Examples

col0 <- c("Y1T1", "Y1T2", "Y1trim3", "Y1T4", "Y2T1", "Y2-T2")
col1 <- c(12, 11, 7, 6, 9, 10)
col2 <- c(12, 11, 7, 6, 9, 14)
col3 <- c(12, 11, 3, 6, 9, 4)
col4 <- c(12, 11, 7, 6, 9, 4)
col5 <- c(12, 11, 7, 3, 9, 4)
df1 <- data.frame(col0, col1, col2, col3, col4, col5)

plushautniveau(df1)
plushautniveau(df1, nbperiode = 5)
plushautniveau(df1, vary = "col2")
plushautniveau(df1, vary = "col3")
plushautniveau(df1, vary = "col4")

Fournit dynamiquement le mois précédent

Description

Retourne la formulation du mois situé à k périodes avant le mois indiqué.

Usage

prevMois(
  mois,
  annee,
  type = c("Annee", "autres"),
  majuscule = FALSE,
  k = 1,
  lang = get_serad_language()
)

Arguments

Value

Une chaîne de caractères correspondant au mois précédent.

See Also

prevTrim, nextMois, quelMois

Examples

prevMois(1, 2023)
prevMois(12, 2023, k = 2)

Fournit dynamiquement le trimestre précédent

Description

Retourne la formulation du trimestre situé à k périodes avant le trimestre indiqué.

Usage

prevTrim(
  trim,
  annee,
  type = c("lettres", "chiffres"),
  majuscule = FALSE,
  exposant = TRUE,
  k = 1,
  lang = get_serad_language()
)

Arguments

Value

Une chaîne de caractères correspondant au trimestre précédent.

See Also

nextTrim, quelTrim

Examples

prevTrim(1, 2023)
prevTrim(1, 2023, type = "chiffres", exposant = FALSE)

Fournit dynamiquement le mois en toutes lettres

Description

Retourne une formulation littéraire du mois, avec ou sans année.

Usage

quelMois(
  mois,
  annee,
  type = c("Annee", "autres"),
  majuscule = FALSE,
  lang = get_serad_language()
)

Arguments

Value

Une chaîne de caractères correspondant au mois, avec ou sans année.

See Also

quelTrim, nextMois, prevMois

Examples

quelMois(3, 2023)
quelMois(3, 2023, majuscule = TRUE)
quelMois(3, 2023, type = "autres")

Fournit dynamiquement le trimestre en toutes lettres ou en chiffres

Description

Retourne une formulation littéraire du trimestre pour une année donnée.

Usage

quelTrim(
  trim,
  annee,
  type = c("lettres", "chiffres"),
  majuscule = FALSE,
  exposant = TRUE,
  mois = NULL,
  lang = get_serad_language()
)

Arguments

Value

Une chaîne de caractères du type "troisième trimestre 2023" ou "3^e^ trimestre 2023".

See Also

nextTrim, prevTrim

Examples

quelTrim(3, 2023)
quelTrim(3, 2023, majuscule = TRUE)
quelTrim(3, 2023, type = "chiffres")
quelTrim(1, 2023, type = "chiffres")
quelTrim(999, 2023, type = "chiffres", mois = 8)
quelTrim(3, 2023, type = "chiffres", exposant = FALSE)

Met au pluriel selon la valeur numérique

Description

Retourne la forme singulière ou plurielle selon la valeur absolue du nombre.

Usage

s(a, sing = "", plur = "s", seuil = 2)

Arguments

Value

Une chaîne de caractères correspondant à la forme correctement accordée. NA si l'entrée est NA.

See Also

https://www.dictionnaire-academie.fr/article/QDL057

Examples

serad::s(-7.5)
serad::s(-2)
serad::s(1.4, "chat parle", "chats parlent")
serad::s(-2, "chat parle", "chats parlent")
serad::s(1.97)
serad::s(arrondi_tot(1.97))
serad::s(1.97, seuil = 1.95)

Définit la langue de serad

Description

Modifie la langue utilisée par {serad} et réinitialise les règles de rédaction associées.

Usage

set_serad_language(lang = c("fr", "en"))

Arguments

Value

NULL invisiblement.

Récupère le numéro du mois à partir d'un texte

Description

Extrait le numéro du mois (1 à 12) à partir d'une chaîne de caractères contenant un mois en format abrégé ou littéraire.

Usage

whichMois(mois)

Arguments

Value

Un entier entre 1 et 12 si un mois est détecté, 0 sinon. NA si l'entrée est NA.

See Also

quelMois

Examples

whichMois("En juil. 98")