INTEGER-OF-DATE

Syntaxe

Paramètres

Description

Cette fonction permet de convertir une date de format grégorien en un format entier.

Remarques

• La fonction INTEGER-OF-DATE est essentielle pour effectuer des opérations arithmétiques sur des dates. En convertissant une date en un entier séquentiel, elle permet de mesurer facilement le nombre de jours entre deux dates par simple soustraction, ce qui est impossible avec des dates formatées sous forme AAAAMMJJ.
• Le paramètre dater doit représenter une date grégorienne valide, souvent sous la forme d'un champ structuré contenant l'année, le mois et le jour. Si la date est invalide ou mal formatée, la fonction retournera une valeur erronée ou entraînera un comportement imprévisible, il est donc crucial de valider l'entrée.
• Le nombre entier retourné par INTEGER-OF-DATE correspond au nombre de jours écoulés depuis une date de référence fixe. En général, COBOL utilise le 1er janvier de l'an 1601 comme base, mais cela dépend de l'implémentation du compilateur.
• Cette fonction est souvent utilisée avec son pendant inverse, DATE-OF-INTEGER, pour convertir un entier en date. Cela permet de stocker les dates dans des formats numériques compacts ou d'ajouter un nombre de jours à une date sans gestion manuelle des mois ou années.
• Elle est particulièrement utile dans les calculs de délais, d'échéances ou d'âges. Par exemple, pour calculer combien de jours il reste entre aujourd'hui et une date d'expiration, on convertit les deux dates en entiers puis on fait la soustraction.
• INTEGER-OF-DATE évite les erreurs liées aux calendriers complexes, comme les années bissextiles, les mois de 30 ou 31 jours, etc. Ces ajustements sont pris en charge en interne, ce qui simplifie grandement la logique des programmes.
• Comme cette fonction renvoie une valeur entière, elle peut être facilement entreposée, comparée ou triée dans des tableaux ou des fichiers séquentiels. Cela en fait une méthode efficace pour organiser des données temporelles en mémoire ou sur disque.
• Même si elle semble simple, INTEGER-OF-DATE est une fonction très puissante dans les applications de gestion, notamment dans les domaines bancaires, administratifs ou logistiques. Sa fiabilité dans la manipulation des dates permet d'éviter des erreurs fréquentes dues à la gestion manuelle des calendriers.