La propriété
Mois permet de :
- Récupérer le mois d'une variable de type Date ou DateHeure.
- Modifier le mois d'une variable de type Date ou DateHeure.
- Récupérer le mois d'une rubrique de type Date (au format "Date simple" ou "Date et Heure").
- Modifier le mois d'une rubrique de type Date (au format "Date simple" ou "Date et Heure").
Remarque : La propriété Mois permet de simplifier les opérations de décalage sur les dates (ajouter un mois, etc.).
Rappel : Les rubriques de type Date permet de gérer :
- les dates simples "Année - Mois - Jour" (format AAAAMMJJ)
- les dates et les heures "Année - Mois - Jour - Heures - Minutes - Secondes - Millièmes de seconde" (format AAAAMMJJHHmmSSCCC)
- les durées "Nombre de jours - Nombre d'heures - Nombre de minutes - Nombre de secondes - Nombre de millièmes de seconde" (format +JHHMMSSCCC)
// Manipulations sur une variable de type Date
DateDébut est une Date = "20011212"
// Ajouter 1 mois à la date
DateDébut.Mois++
// Modifier le mois
DateDébut.Mois = 5
// Manipulations sur une rubrique
Travail.DateDébut = "20011212"
// Ajouter 1 mois à la date
Travail.DateDébut.Mois++
// Modifier le mois
Travail.DateDébut.Mois = 5
Syntaxe
Connaître le mois d'une variable Date ou DateHeure Masquer les détails
<Résultat> = <Date>.Mois
<Résultat> : Entier
Mois sur 2 chiffres.
<Date> : Date ou DateHeure
Nom de la variable de type Date ou DateHeure à manipuler.
Modifier le mois d'une variable Date ou DateHeure Masquer les détails
<Date>.Mois = <Nouveau mois>
<Date> : Date ou DateHeure
Nom de la variable de type Date ou DateHeure à manipuler.
<Nouveau mois> : Entier ou chaîne de caractères
Nouveau mois en chiffres (compris entre 1 et 12). Remplace le mois de la date manipulée.
Connaître le mois d'une rubrique Date (format "Date simple" ou "Date et Heure") Masquer les détails
<Résultat> = <Fichier de données>.<Rubrique>.Mois
<Résultat> : Entier
Mois sur 2 chiffres.
<Fichier de données> : Chaîne de caractères
Nom du fichier de données manipulé. Ce nom a été défini sous l'éditeur d'analyses ou grâce au type Description de Fichier.
<Rubrique> : Chaîne de caractères
Nom de la rubrique manipulée. Ce nom a été défini sous l'éditeur d'analyses ou grâce au type Description de Rubrique.
Modifier le mois d'une rubrique Date (format "Date simple" ou "Date et Heure") Masquer les détails
<Fichier de données>.<Rubrique>.Mois = <Nouveau mois>
<Fichier de données> : Chaîne de caractères
Nom du fichier de données manipulé. Ce nom a été défini sous l'éditeur d'analyses ou grâce au type Description de Fichier.
<Rubrique> : Chaîne de caractères
Nom de la rubrique manipulée. Ce nom a été défini sous l'éditeur d'analyses ou grâce au type Description de Rubrique.
<Nouveau mois> : Entier ou chaîne de caractères
Nouveau mois en chiffres (compris entre 1 et 12). Remplace le mois de la date manipulée.
Remarques
Plage de dates
Les types
Date et
DateHeure permettent de gérer des dates du 01/01/0001 au 31/12/9999.
Gestion des mois et des années
Cas 1 : Affectation directeLors d'une affectation directe (par exemple,
MonTravail.MaDate.Mois = n), le mois doit être compris entre 01 et 12. Si le mois spécifié est supérieur, une erreur du WLangage est générée.
La notation
MonTravail.MaDate.Mois = MonTravail.MaDate.Mois + 5 risque de générer une erreur en exécution. Par exemple, les codes suivants provoquent une erreur :
// Code provoquant l'erreur
MaDate est une Date = "20201126" // le 26/11/2020
MaDate.Mois = MaDate.Mois + 2
// Provoque une erreur WLangage car le mois est égal à 13
// Code correct
MaDate est une Date = "20201126" // le 26/11/2020
MaDate.Mois += 2
// Code provoquant l'erreur
MaDate est une Date = "20201126" // le 26/11/2020
MaDate1 est une Date
MaDate1.Mois = MaDate.Mois + 2
// Provoque une erreur WLangage car le mois est égal à 13
// Code correct
MaDate1 = MaDate // le 26/11/2020
MaDate1.Mois += 2
Cas 2 : Opérations sur les moisLors d'opérations sur les dates, le changement d'année est automatiquement géré. Ainsi, si le nombre de mois est supérieur à 12, l'année est automatiquement modifiée et le nombre de mois repart de 1.
Par exemple :
DateDébut est une Date = "20201226" // Le 26/12/2020
// Ajouter 5 mois à la date
DateDébut.Mois += 5 // DateDébut vaut "20210526"
Opérateurs disponibles sur les mois
Les opérateurs arithmétiques suivants peuvent être utilisés avec la propriété
Mois :
DateDébut est une Date = "20201126"
DateDébut.Mois++ // Ajouter 1 mois à la date
DateDébut.Mois+=5 // Ajouter 5 mois à la date
DateDébut.Mois-=5 // Retrancher 5 mois à la date
Calculer le dernier jour du mois
Pour obtenir le dernier jour d'un mois, il suffit d'affecter la propriété
Jour de la date avec 31. Le dernier jour sera alors automatiquement calculé en fonction du mois spécifié.
DateDébut est une Date = "20201126"
DateDébut.Jour = 31
// La date 31 est impossible pour le mois de novembre
// Elle est automatiquement remplacée par 30
Calculer une échéance à 90 jours fin de mois
La propriété
Jour permet de calculer la date de fin d'une échéance à 90 jours fin de mois.
MaDate est une Date = "20201126"
MaDate.Jour += 90
MaDate.Jour = 31
Calculer la fin d'un mois flottant
Un mois flottant correspond à une période d'un mois à partir d'une date donnée. Les propriétés
Mois et
Jour permettent de calculer simplement la date de fin d'un mois flottant.
DateDébut est une Date = "20201126"
DateFin est une Date = DateDébut
DateFin.Mois++
DateFin.Jour--
Liste des exemples associés :
|
Exemples unitaires (WINDEV) : Gestion des dates
[ + ] Utilisation du type Date du WLangage et des fonctions de manipulations de dates.
|