rainette_convertir.php
Ce fichier contient les fonctions de conversion entre unités, en particulier, les conversions du système métrique vers le système impérial US.
Table of Contents
Constants
- _RAINETTE_ICONE_EXTENSIONS = ['png', 'svg']
- Liste des extensions possibles pour les icones dans l'ordre de préférence.
- _RAINETTE_ICONE_NOM_NA = 'na'
- Nom de l'icone n/a par défaut si le thème ne le fournit pas.
- _RAINETTE_ICONE_NOM_VIDE = 'icone-vide'
- Nom de l'icone vide par défaut.
Functions
- lister_directions() : array<string|int, mixed>
- Lister les 16 directions abrégées en anglais ainsi que la direction variable.
- angle2direction() : string
- Convertit un angle en degré en une direction sur 16 valeurs.
- indice2risque_uv() : string
- Convertit un indice UV normalisé en une chaine correspondant à un niveau de risque.
- kilometre2mile() : null|float
- Convertit des kilomètres en miles.
- mile2kilometre() : null|float
- Convertit des miles en kilomètres.
- celsius2farenheit() : null|float
- Convertit des températures celsius en farenheit.
- farenheit2celsius() : null|float
- Convertit des températures celsius en farenheit.
- millimetre2inch() : null|float
- Convertit des millimètres en pouces.
- millibar2inch() : null|float
- Convertit des pressions millibar en pouces.
- temperature2pointrosee() : null|float
- Calcule la température de rosée en fonction de la température ambiente et de l'humidité (en pourcentage).
- temperature2ressenti() : null|float
- Calcule la température ressentie par refroidissement éolien ou l'humidex.
- metre2kilometre() : null|float
- Convertit en kilomètres une valeur en mètres.
- metre_seconde2kilometre_heure() : null|float
- Convertit en kilomètres par heure une valeur en mètres par seconde.
- code_meteo2icone() : string
- Calcule le chemin de l'icone local à utiliser.
Constants
_RAINETTE_ICONE_EXTENSIONS
Liste des extensions possibles pour les icones dans l'ordre de préférence.
public
mixed
_RAINETTE_ICONE_EXTENSIONS
= ['png', 'svg']
_RAINETTE_ICONE_NOM_NA
Nom de l'icone n/a par défaut si le thème ne le fournit pas.
public
mixed
_RAINETTE_ICONE_NOM_NA
= 'na'
_RAINETTE_ICONE_NOM_VIDE
Nom de l'icone vide par défaut.
public
mixed
_RAINETTE_ICONE_NOM_VIDE
= 'icone-vide'
Functions
lister_directions()
Lister les 16 directions abrégées en anglais ainsi que la direction variable.
lister_directions() : array<string|int, mixed>
Return values
array<string|int, mixed> —Liste des directions abrégées.
angle2direction()
Convertit un angle en degré en une direction sur 16 valeurs.
angle2direction([null|int $angle = null ]) : string
Parameters
- $angle : null|int = null
-
Angle du vent exprimé en degrés.
Return values
string —Direction du vent en abrégée anglais standard selon 16 directions.
indice2risque_uv()
Convertit un indice UV normalisé en une chaine correspondant à un niveau de risque.
indice2risque_uv([null|float $indice_uv = null ]) : string
Parameters
- $indice_uv : null|float = null
-
Entier représentant l'indice UV
Tags
Return values
string —Chaine représentant le risque lié à l'indice UV. Cette chaine permet de calculer l'item de langue du risque dans la langue requise.
kilometre2mile()
Convertit des kilomètres en miles.
kilometre2mile([null|float $kilometre = null ]) : null|float
Parameters
- $kilometre : null|float = null
-
La valeur réelle en kilomètres.
Return values
null|float —La valeur réelle correspondante convertie en miles
mile2kilometre()
Convertit des miles en kilomètres.
mile2kilometre([null|float $miles = null ]) : null|float
Parameters
- $miles : null|float = null
-
La valeur réelle en miles.
Return values
null|float —La valeur réelle correspondante convertie en kilomètres
celsius2farenheit()
Convertit des températures celsius en farenheit.
celsius2farenheit([null|int $celsius = null ]) : null|float
Parameters
- $celsius : null|int = null
-
La valeur réelle en degrés celsius.
Return values
null|float —La valeur réelle correspondante convertie en farenheit.
farenheit2celsius()
Convertit des températures celsius en farenheit.
farenheit2celsius([null|int $farenheit = null ]) : null|float
Parameters
- $farenheit : null|int = null
-
La valeur réelle en degrés celsius.
Return values
null|float —La valeur réelle correspondante convertie en farenheit.
millimetre2inch()
Convertit des millimètres en pouces.
millimetre2inch([null|float $millimetre = null ]) : null|float
Parameters
- $millimetre : null|float = null
-
La valeur réelle en millimètres
Return values
null|float —La valeur réelle correspondante convertie en pouces.
millibar2inch()
Convertit des pressions millibar en pouces.
millibar2inch([null|float $millibar = null ]) : null|float
Parameters
- $millibar : null|float = null
-
La valeur réelle en millibars
Return values
null|float —La valeur réelle correspondante convertie en pouces.
temperature2pointrosee()
Calcule la température de rosée en fonction de la température ambiente et de l'humidité (en pourcentage).
temperature2pointrosee([null|float $temperature = null ][, null|float $humidite = null ][, null|string $unite = 'm' ]) : null|float
On utilise la formule de Heinrich Gustav Magnus-Tetens.
Parameters
- $temperature : null|float = null
-
Température réelle mesurée en celsius.
- $humidite : null|float = null
-
Pourcentage d'humidité.
- $unite : null|string = 'm'
-
Système d'unité métrique (
m
, défaut) ou impérial (s
)
Return values
null|float —La température du point de rosée.
temperature2ressenti()
Calcule la température ressentie par refroidissement éolien ou l'humidex.
temperature2ressenti([null|float $temperature = null ][, null|float $vitesse_vent = null ][, null|float $point_rosee = null ][, null|string $unite = 'm' ]) : null|float
Le calcul par refroidissement éolien n'a de sens que pour des températures réelles supérieures à -50°C et inférieures à 10°C. Au-delà de ces valeurs, la fonction renvoie l'indice humidex la température réelle fournie en entrée. Les calculs nécessitent des données en système métrique.
Parameters
- $temperature : null|float = null
-
Température réelle.
- $vitesse_vent : null|float = null
-
Vitesse du vent.
- $point_rosee : null|float = null
-
Température de rosée.
- $unite : null|string = 'm'
-
Système d'unité métrique (
m
, défaut) ou impérial (s
)
Return values
null|float —'Température ressentie' (indice) arrondie à la première décimale
metre2kilometre()
Convertit en kilomètres une valeur en mètres.
metre2kilometre([null|int $metre = null ]) : null|float
Parameters
- $metre : null|int = null
-
La valeur entière en mètres
Return values
null|float —La valeur correspondante convertie en kilomètres.
metre_seconde2kilometre_heure()
Convertit en kilomètres par heure une valeur en mètres par seconde.
metre_seconde2kilometre_heure([null|float $vitesse_vent = null ]) : null|float
Parameters
- $vitesse_vent : null|float = null
-
Vitesse du vent en mètres par seconde.
Return values
null|float —La valeur correspondante convertie en kilomètres par heure.
code_meteo2icone()
Calcule le chemin de l'icone local à utiliser.
code_meteo2icone(int|string $code, int $periode, array<string|int, mixed> $parametres_icone) : string
La fonction considère qu'au moment où elle est appelée, les données code
et periode
sont correctement remplis
par le service (nativement ou par complétion).
Parameters
- $code : int|string
-
Code méteo retourné par le service et servant d'index pour définir l'icone.
- $periode : int
-
Indicateur jour (0) ou nuit (1) et utilisé si les icones différent suivant la période.
- $parametres_icone : array<string|int, mixed>
-
Tableau de paramètres identifiant comment choisir l'icone :
- service : le nom du service dont est issu le code.
- transcodages : les tableaux de transcodages code / icone du service
- theme_origine : le type de thème parmi 'local', 'weather', 'wmo' (index de transcodage)
- theme_id : l'id du thème
- periode_stricte : indique qu'on ne cherche que l'icone de la période (défaut false)
Tags
Return values
string —Le chemin de l'icone