PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Plage de dates
  • Gestion des jours et des mois
  • Manipulation des durées
  • Opérateurs disponibles sur les jours
  • Calculer le dernier jour du mois
  • Calculer une échéance à 90 jours fin de mois
  • Calculer la fin d'un mois flottant
  • Calculs sur les dates
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
La propriété ..Jour permet de :
  • Récupérer le jour d'une variable de type Date, DateHeure ou récupérer le nombre de jours d'une variable de type Durée.
  • Modifier le jour d'une variable de type Date, DateHeure ou modifier le nombre de jours d'une variable de type Durée.
  • Récupérer le jour ou le nombre de jours d'une rubrique de type Date (au format "Date", "Date et heure" ou "durée").
    WEBDEV - Code NavigateurPHP Non disponible.
  • Modifier le jour ou le nombre de jours d'une rubrique de type Date (au format "Date", "Date et heure" ou "durée").
    WEBDEV - Code NavigateurPHP Non disponible.
Remarque : La propriété ..Jour permet de simplifier les opérations de décalage sur les dates (ajouter un jour, ...).
Rappel : Les rubriques de type Date permettent 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 AAAAMMJJHHMMSSLLL)
  • les durées "Nombre de jours - Nombre d'heures - Nombre de minutes - Nombre de secondes - Nombre de millièmes de seconde" (format +JHHMMSSLLL)
Versions 16 et supérieures
Universal Windows 10 App Cette propriété est désormais disponible pour les applications Windows Phone.
Nouveauté 16
Universal Windows 10 App Cette propriété est désormais disponible pour les applications Windows Phone.
Universal Windows 10 App Cette propriété est désormais disponible pour les applications Windows Phone.
Versions 17 et supérieures
iPhone/iPad Cette propriété est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette propriété est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette propriété est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
Universal Windows 10 App Cette propriété est désormais disponible en mode Windows Store apps.
Nouveauté 18
Universal Windows 10 App Cette propriété est désormais disponible en mode Windows Store apps.
Universal Windows 10 App Cette propriété est désormais disponible en mode Windows Store apps.
Versions 20 et supérieures
WEBDEV - Code Navigateur Cette propriété est désormais disponible en code navigateur sur les variables de type Date, DateHeure ou Durée.
Nouveauté 20
WEBDEV - Code Navigateur Cette propriété est désormais disponible en code navigateur sur les variables de type Date, DateHeure ou Durée.
WEBDEV - Code Navigateur Cette propriété est désormais disponible en code navigateur sur les variables de type Date, DateHeure ou Durée.
Versions 21 et supérieures
Apple Watch Cette propriété est désormais disponible en mode Apple Watch.
Universal Windows 10 App Cette propriété est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Apple Watch Cette propriété est désormais disponible en mode Apple Watch.
Universal Windows 10 App Cette propriété est désormais disponible en mode Universal Windows 10 App.
Apple Watch Cette propriété est désormais disponible en mode Apple Watch.
Universal Windows 10 App Cette propriété est désormais disponible en mode Universal Windows 10 App.
Exemple
// Exemple sur une variable
DateDébut est une Date = "20011225"
// Ajouter 5 jours à la date
DateDébut..Jour += 5
// Modifier les jours
DateDébut..Jour = 10
// Exemple sur une rubrique
Travail.DateDébut = "20011225"
// Ajouter 5 jours à la date
Travail.DateDébut..Jour += 5
// Modifier les jours
Travail.DateDébut..Jour = 10
Syntaxe

Connaître le jour d'une variable Date, DateHeure ou Durée Masquer les détails

<Résultat> = <Date>..Jour
<Résultat> : Entier
Jour sur 2 chiffres.
<Date> : Date ou DateHeure
Nom de la variable de type Date, DateHeure ou Durée à manipuler.

Modifier le jour d'une variable Date, DateHeure ou Durée Masquer les détails

<Date>..Jour = <Nouveau jour>
<Date> : Date ou DateHeure
Nom de la variable de type Date, DateHeure ou Durée à manipuler.
<Nouveau jour> : Entier ou chaîne de caractères
Nouveau jour en chiffres (compris entre 1 et 31). Remplace le jour de la date manipulée.
WEBDEV - Code NavigateurPHP Non disponible en code navigateur et en PHP

Connaître le jour d'une rubrique de type Date Masquer les détails

<Résultat> = <Fichier de données>.<Rubrique>..Jour
<Résultat> : Entier
Jour sur 2 chiffres.
<Fichier de données> : Chaîne de caractères (avec ou sans guillemets)
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 (avec ou sans guillemets)
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.
WEBDEV - Code NavigateurPHP Non disponible en code navigateur et en PHP

Modifier le jour d'une rubrique de type Date Masquer les détails

<Fichier de données>.<Rubrique>..Jour = <Nouveau jour>
<Fichier de données> : Chaîne de caractères (avec ou sans guillemets)
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 (avec ou sans guillemets)
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 jour> : Entier ou chaîne de caractères
Nouveau jour en chiffres (compris entre 1 et 31). Remplace le jour 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 jours et des mois

Cas 1 : Affectation directe
Lors d'une affectation directe (par exemple, MonJour..Jour = n), le jour doit être compris entre 1 et 31. Si le jour spécifié est supérieur, une erreur du WLangage est générée.
La notation MonJour..Jour = MonJour..Jour + 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 = "20041126"   // le 26/11/2004
MaDate..Jour = MaDate..Jour + 20   // Provoque une erreur WLangage car le jour est égal à 45

// Code correct
MaDate est une Date = "20041126"   // le 26/11/2004
MaDate..Jour += 20

// Code provoquant l'erreur
MaDate est une Date = "20041126"   // le 26/11/2004
MaDate1 est une Date
MaDate1..Jour = MaDate..Jour + 20   // Provoque une erreur WLangage car le jour est égal à 45

// Code correct
MaDate1 = MaDate   // le 26/11/2004
MaDate1..Jour += 20
Cas 2 : Opérations sur les jours
Lors d'opérations sur les dates, le changement de mois est automatiquement géré. Ainsi, si le nombre de jours est supérieur au nombre de jours valide pour le mois manipulé, le nombre de jours repart de 1 et le numéro du mois est automatiquement modifié. L'année est également modifiée si nécessaire (mois de décembre par exemple).
Par exemple :
DateDébut est une Date = "20041226"   // Le 26/12/2004
// Ajouter 10 jours à la date
DateDébut..Jour +=10    // DateDébut vaut "20050105"

Manipulation des durées

Une durée n'a pas de limites : son nombre de jours peut dépasser 30 ou 31 jours.

Opérateurs disponibles sur les jours

Les opérateurs arithmétiques suivants peuvent être utilisés avec la propriété ..Jour :
  • ++ et --
  • += et - =
DateDébut est une Date = "20041126"  
DateDébut..Jour++     // Ajouter 1 jour à la date
DateDébut..Jour+=5    // Ajouter 5 jours à la date
DateDébut..Jour-=5    // Retrancher 5 jours à 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 = "20041126"  
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 = "20041126"  
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 = "20041126"  
DateFin est une Date = DateDébut
DateFin..Mois++    
DateFin..Jour--

Calculs sur les dates

Le format de stockage des dates permet de stocker des dates comprises entre le 01/01/0001 et le 31/12/9999.
Les calculs sur les dates réalisés avec les fonctions WLangage ou les propriétés WLangage sont fiables à partir du 1er Janvier 1583.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire