Ce document décrit l'utilisation de l'extension NumberText version 0.9.
Vous devez avoir installé cette extension pour que les exemples fonctionnent.
Une fois installée, vous disposez de deux nouvelles fonctions dans la catégorie Add-in :
NUMBERTEXT( ) renvoie une chaîne de caractères exprimant la valeur du nombre donné en argument 1.
L'argument 2, facultatif, permet de choisir la langue du texte obtenu.
MONEYTEXT( ) renvoie une chaîne de caractères exprimant la valeur monétaire du nombre donné en
argument 1.
L'argument 2, facultatif, permet de choisir la devise monétaire.
L'argument 3, facultatif, permet de choisir la langue du texte obtenu.
Les devises disponibles pour un texte en français sont listées en colonne B.
Cette liste se trouve dans le fichier numbertext_fr_FR.py dans l'arbre de l'extension installée.
La feuille Langues liste les codes de langue acceptés.
En général il suffit d'indiquer les deux premiers caractères, par exemple en pour l'anglais.
La langue par défaut est celle dans Outils > Options > Langages > par défaut pour les documents
La devise par défaut est déduite de la langue par défaut : Espagnol (Mexique) -> peso mexicain
Combinaisons entre langue et devise:
Seules les langues ayant prévu la devise choisie peuvent créer un texte monétaire.
Par exemple, la devise AUD est acceptée avec la langue en mais pas fr.
La feuille Formules donne des exemples de formules Calc.
La feuille Programmation montre comment utiliser ces fonctions dans un programme Basic.
723617570 : Infos Page 1/11 01/29/2024
Devise
EUR euro
USD dollar américain
GBP livre sterling
CHF franc suisse
CAD dollar canadien
XAF franc CFA
XOF franc CFA
XPF franc pacifique
DZD dinar algérien
MAD dirham marocain
TND dinar tunisien
BIF franc burundais
CDF franc congolais
DJF franc djiboutien
GNF franc guinéen
HTF gourde haïtienne
KMF franc comorien
LBP livre libanaise
MGA ariary malgache
MRO ouguiya mauritanien
MUR roupie mauricienne
RWF franc rwandais
SCR roupie seychelloise
VUV vatu de vanuatu
723617570 : Infos Page 2/11 01/29/2024
Le tableau qui suit est extrait du fichier README de l'extension.
Le code langue réduit aux deux premiers caractères est suffisant.
Code Langue Dialecte Note
af-ZA Africaans
ca-ES Catalan
cs-CZ Czech
da-DK Danish
de-DE German
el-EL Greek
en-IN English with Indian numbering system (lakh = 100.000, crone = 10^7)
en-US English (USD 20.25 -> twenty dollars and twenty-five cents)
en-US-2 English variant (USD 20.25 -> twenty and 25/100 dollars)
eo Esperanto
es-ES Spanish
fi-FI Finnish
fr-BE Belgian French
fr-CH Swiss French
fr-FR French
he-IL Hebrew
hu-HU Hungarian
hu-HU_2 Hungarian (formal)
it-IT Italian
ja-JP Japanese
ja-JP-2 Japanese (formal)
ko-KP North-Korean
ko-KR South-Korean
lb-LU Luxembourgish
nl-NL Dutch
pl-PL Polish
pt-BR Brazilian Portuguese
pt-PT Portuguese
ro-RO Romanian
ru-RU Russian
sh-RS Serbian
sl-SI Slovenian
sr-RS Serbian
sv-SV Swedish
th-TH Thai
tr-TR Turkish
zh-ZH Chinese (simplified)
zh-ZH-2 Chinese (simplified, formal)
Numérotations anciennes
Hung Old Hungarian Script non reconnu en version 0.9.1
Roman Roman numbers (parenthesized variant)
Roman_2 Roman numbers (with overline, bars, and optionally special characters)
Suzhou Chinese Suzhou numerals
723617570 : Langues Page 3/11 01/29/2024
Devise Langue Valeur
fr 1357.89
CHF fr-CH 18597215.78
123456
123456
47.486486486487
47.486
-155.96
60
USD 1567898.896
153,13
EUR fr-BE 300
help
fr-CH 399
Roman help
Roman 1789
Roman 153250317
Roman_2
AUD en 357
INR en-IN 567285500
UYU es-ES 98765.43
ARS es-ES 98765.43
723617570 : Formules Page 4/11 01/29/2024
en help
723617570 : Formules Page 5/11 01/29/2024
Formule
mille trois cent cinquante-sept virgule quatre-vingt-neuf
dix-huit millions cinq cent nonante-sept mille deux cent quinze francs suisses et
septante-huit centimes
cent vingt-trois mille quatre cent cinquante-six
cent vingt-trois mille quatre cent cinquante-six euros
quarante-sept virgule quatre billions huit cent soixante-quatre milliards huit cent
soixante-quatre millions huit cent soixante-quatre mille huit cent soixante-cinq
quarante-sept virgule quatre cent quatre-vingt-six
moins cent cinquante-cinq virgule quatre-vingt-seize
soixante euros
un million cinq cent soixante-sept mille huit cent quatre-vingt-dix-huit dollars
américains et quatre-vingt-dix cents
cent cinquante-trois virgule treize
zéro euro
trois cent euros
deux cent soixante et un euros
Functions: ord ordinal numbers
ordf feminine ordinal numbers
ordm masculine ordinal numbers
trois cent nonante-neuvième
premier
première
Modules
Roman: multiple parenthesized form
Roman_2: overline (×1000) with bar (×100)
Functions: historical (in Roman_2) with special Unicode characters for 1000, 5000
and 10000
MDCCLXXXIX
((CLIII)CCL)CCCXVII
|M̅ D̅ X̅ X̅ X̅ I̅ I̅ |L̅ CCCXVII
three hundred and fifty-seven Australian dollars
fifty-six crore, seventy-two lakh eighty-five thousand five hundred Indian rupees
noventa y ocho mil setecientos sesenta y cinco pesos uruguayos y cuarenta y tres
centésimos
noventa y ocho mil setecientos sesenta y cinco pesos argentinos y cuarenta y tres
centavos
723617570 : Formules Page 6/11 01/29/2024
Functions:
ord (ordinal numbers, eg. "first")
ord2 (ordinal abbreviations, eg. "1st")
Extra modules:
en_US_2 (subunit as decimal fraction: "USD 20.25" -> twenty and 25/100 dollars)
723617570 : Formules Page 7/11 01/29/2024
Remarques
NUMBERTEXT
MONEYTEXT
paramètres par défaut
paramètres par défaut
Il vaut mieux limiter le
nombre de décimales !
nombre négatif
Langue et devise par défaut
Notez l'arrondi implicite à 2
décimales (ne fonctionne
pas dans quelques cas)
Marche aussi avec une
cellule texte !
petite faute d'orthographe
Petite aide sur les nombres
ordinaux
ordinal féminin
ordinal masculin
ordinal féminin
Petite aide sur les nombres
romains
Notation romaine classique
Grand nombre en romain
Variante de grand nombre
Devise connue en anglais
Devise connue en anglais
Devise connue en espagnol
Devise connue en espagnol
723617570 : Formules Page 8/11 01/29/2024
Petite aide pour l'anglais
723617570 : Formules Page 9/11 01/29/2024
Le Module1 de la bibliothèque Standard de ce document contient les fonctions NombreTexte( ) et ArgentTexte( ).
Elles renvoient une chaîne de caractères.
Les arguments 1 et 2 sont identiques contrairement aux fonctions Calc NUMBERTEXT et MONEYTEXT.
Ces macros ne sont pas nécessaires si vous vous contentez d'utiliser NUMBERTEXT MONEYTEXT dans des formules.
Inversement, ces macros sont utilisables dans tout programme [Link], pas seulement Calc, mais Writer, Draw, etc.
Cliquer pour exécuter un exemple (macro Main)
L'extension NumberText est un Add-in codé en langage Python. Plus d'informations en anglais, voir le site [Link]
Le codage est extrêmement efficace et subtil, instructif mais pas à la portée d'un débutant.
723617570 : Programmation Page 10/11 01/29/2024
[Link].
723617570 : Programmation Page 11/11 01/29/2024