DateUtils

DateUtils

Quelques fonctions simplifiant l'utilisation du type ${\color{LimeGreen}\normalsize{\textsf{DateTime}}}$.

Obtenir le temps actuel

Cette fonction permet d'obtenir le temps actuel sous forme de nombre de secondes écoulées depuis l'époque Unix.

// Exemple d'utilisation : obtenir le temps actuel en nombre de secondes
long currentTime = DateUtils.GetCurrentTime();

Comparer avec le temps actuel

Cette fonction permet de comparer un temps donné avec le temps actuel et de calculer le temps écoulé depuis ce temps donné.

Voici les paramètres de cette fonction.

• ${\color{Goldenrod}\normalsize{\textsf{time}}}$ : Le temps actuel en nombre de secondes depuis l'époque Unix.

// Exemple d'utilisation : comparer un temps donné avec le temps actuel
long savedTime = 3052024; // Exemple de temps sauvegardé
TimeSpan elapsedTime = DateUtils.CompareWithCurrentTime(savedTime);

Obtenir une date numérique

Une méthode consistant à récupérer la date d'aujourd'hui au format "ddMMyyyy".

DateUtils.GetNumericalDateOfTheDay();

Convertir une date numérique

Cette fonction permet de lire et de renvoyer une date numérique.

Voici les paramètres de cette fonction.

• ${\color{Goldenrod}\normalsize{\textsf{numericalDate}}}$ : Date au format numérique.

//Dans cette exemple, nous allons obtenir "03/05/2024"
DateUtils.ConvertNumericalDateToString(3052024);

Vérifier si l'heure actuelle est comprise entre deux valeurs

Cette fonction permet de vérifier si l'heure actuelle est comprise entre deux heures données.

Voici les paramètres de cette fonction :

• ${\color{Goldenrod}\normalsize{\textsf{start}}}$ : Heure de début (au format 24 heures).
• ${\color{Goldenrod}\normalsize{\textsf{end}}}$ : Heure de fin (au format 24 heures).

// Dans cet exemple, si l'heure actuelle est 15h00, la fonction retournera true :
bool isBetween = TimeUtils.IsCurrentTimeBetween(14, 16);

Formater des secondes en heures, minutes et secondes

Cette fonction permet de formater un nombre de secondes en une chaîne de caractères lisible (heures, minutes, secondes).

Voici les paramètres de cette fonction :

• ${\color{Goldenrod}\normalsize{\textsf{seconds}}}$ : Nombre de secondes à formater.

// Dans cet exemple, nous allons formater 3665 secondes en "1 heure, 1 minute et 5 secondes" :
string formattedTime = TimeUtils.FormatTime(3665);

Formater un timestamp Unix

Cette fonction permet de formater un timestamp Unix (en secondes) en une chaîne de caractères contenant le jour de la semaine, le jour du mois, le mois, et l'heure.

Voici les paramètres de cette fonction :

• ${\color{Goldenrod}\normalsize{\textsf{unixTimestamp}}}$ : Timestamp Unix (en secondes depuis le 1er janvier 1970).

// Dans cet exemple, un timestamp Unix sera converti en une chaîne lisible, comme "lundi 3 mai à 14h30" :
string formattedDate = TimeUtils.FormatUnixTimestamp(1728198657);;

Obtenir le nombre de secondes à partir d'un nombre de jours

Cette fonction permet de convertir un nombre de jours en secondes.

Voici les paramètres de cette fonction :

• ${\color{Goldenrod}\normalsize{\textsf{days}}}$ : Nombre de jours à convertir en secondes.

// Dans cet exemple, nous allons obtenir 86400 secondes pour 1 jour :
long seconds = TimeUtils.GetSecondsFromDays(1);