Fonctions date-heure standard spécifiques à Maintain

Dans cette section :

 

Les fonctions date-heure standard doivent être utilisées avec des dates non propriétaires. Pour une définition des dates et heures standard, consultez Fonctions Date-Heure.


Haut de page

x
HHMMSS : Récupérer l'heure actuelle (Maintain)

Comment :

La fonction HHMMSS permet d'extraire l'heure actuelle du système d'exploitation en tant que chaîne de huit caractères, séparant les heures, les minutes et les secondes par des points.

Pour utiliser cette fonction, vous devez importer la bibliothèque de fonctions MNTUWS. Pour informations sur l'import d'une bibliothèque de fonctions, consultez Invoquer une Fonction.

Il existe aussi une fonction HHMMSS disponible pour le langage reporting. Pour plus d'informations sur cette fonction, consultez HHMMSS : Récupérer l'heure actuelle.



x
Syntaxe : Récupérer l'heure actuelle
HHMMSS()


Exemple : Récupérer l'heure actuelle

Extrait l'heure actuelle du système :

MAINTAIN
Module Import (mntuws);
Case Top
Compute now/a10 = hhmmss();
type "Now = <<now"
EndCase
END

La sortie est :

Now = 14.25.33

Haut de page

x
Initial_HHMMSS : Renvoyer l'heure de démarrage de l'application

Comment :

La fonction Initial_HHMMSS permet de renvoyer l'heure à laquelle l'application Maintain a démarré en tant que chaîne de huit caractères, séparant les heures, les minutes et les secondes par des points.

Pour utiliser cette fonction, vous devez importer la bibliothèque de fonctions MNTUWS. Pour informations sur l'import de cette bibliothèque, consultez Invoquer une Fonction.



x
Syntaxe : Récupérer l'heure actuelle
Initial_HHMMSS()

Haut de page

x
Initial_TODAY : Renvoyer la date de démarrage de l'application

Comment :

La fonction Initial_TODAY permet de renvoyer la date au format MM/DD/YY lorsque l'application Maintain est démarrée en tant que chaîne de huit caractères avec des barres obliques incorporées.

Pour utiliser cette fonction, vous devez importer la bibliothèque de fonctions MNTUWS. Pour informations sur l'import de cette bibliothèque, consultez Invoquer une Fonction.



x
Syntaxe : Récupérer la date actuelle
Initial_TODAY()

Haut de page

x
TODAY : Extraire la date en cours (Maintain)

Comment :

La fonction TODAY extrait la date actuelle du système d'exploitation en format MM/DD/YY ou MM/DD/YYYY. La date renvoyée est toujours actuelle. Par conséquent, si vous exécutez une application tard dans la nuit, utilisez TODAY. Vous pouvez supprimer les barres obliques intégrées à l'aide de la fonction EDIT.

Pour utiliser cette fonction, vous devez importer la bibliothèque de fonctions MNTUWS. Pour informations sur l'import de cette bibliothèque, consultez Invoquer une Fonction.

Il existe une version de la fonction TODAY qui est disponible uniquement dans le langage reporting. Pour plus d'informations sur cette fonction, consultez HTMTOTS ou TIMETOTS : Convertir une heure en horodatage.



x
Syntaxe : Récupérer la date actuelle
TODAY()


Exemple : Récupérer la date actuelle

Extrait la date actuelle du système :

MAINTAIN
Module Import (mntuws);
 
Case Top
Compute date1/a8 = today();
type "Date1 = <<date1"
Endcase
END

Le résultat est :

Date1 = 07/17/02

Haut de page

x
TODAY2 : Retourner une date actuelle

Comment :

La fonction TODAY2 extrait la date actuelle du système d'exploitation en format MM/DD/YYYY. Utilisez le format A10 avec la fonction TODAY2 pour assurer l'obtention de résultats corrects.

Pour utiliser cette fonction, vous devez importer la bibliothèque de fonctions MNTUWS. Pour informations sur l'import de cette bibliothèque, consultez Invoquer une Fonction.



x
Syntaxe : Récupérer la date actuelle
TODAY2()


Exemple : Récupérer la date actuelle

Extrait la date actuelle du système :

MAINTAIN
Module Import (mntuws);
 
Case Top
Compute date2/a10 = today2();
type "Date2 = <<date2"
Endcase
END

Le résultat est :

Date2 = 07/17/2002

Haut de page

x
ADD : Ajouter des jours à une date

Comment :

La fonction ADD ajoute un nombre donné de jours à une date.



x
Syntaxe : Ajouter des jours à une date
ADD(date,value)

ou

date.ADD(value)

où :

date
est la date à laquelle ajouter des jours, ou le champ qui contient la date.
value
est le nombre de jours par lequel augmenter la date.

Cette fonction modifie la valeur de date.



Exemple : Ajouter des jours à une date

ADD ajoute 10 jours à chaque valeur d'un champ DateVar :

ADD(DateVar, 10)

Les valeurs suivantes sont des exemples pour DateVar et les valeurs correspondantes pour ADD(DateVar, 10) :

DateVar      ADD(DateVar, 10);
-------      -----------------
12/31/1999   01/10/2000
01/01/2000   01/11/2000
01/02/2000   01/12/2000

Haut de page

x
DAY : Extraire le jour du mois à partir d'une date

Comment :

La fonction DAY extrait le jour du mois de la date et renvoie le résultat sous forme d'entier.



x
Syntaxe : Extraire le jour du mois à partir d'une date
DAY(date);

où :

date
est la date (au format Date) à partir de laquelle extraire le jour du mois, ou un champ contenant la date.


Exemple : Extraire le jour du mois à partir d'une date

DAY extrait le jour du mois à partir d'un champ DATE :

DAY(DATE)

Les valeurs suivantes sont des exemples pour DATE et les valeurs correspondantes pour DAY(DATE) :

DATE         DAY(DATE)
----         ---------
01/01/2000   1
01/02/2000   2
01/03/2000   3

Haut de page

x
JULIAN : Determiner combien de jours se sont écoulés dans l'année

Comment :

La fonction JULIAN détermine le nombre de jours qui se sont écoulés dans l'année donnée, à une date donnée, et renvoie le résultat sous forme d'entier.



x
Syntaxe : Determiner combien de jours se sont écoulés dans l'année
JULIAN(date);

où :

date
est la date (au format Date) pour laquelle déterminer le nombre de jours écoulés dans une date donnée, ou un champ contenant la date.


Exemple : Determiner combien de jours se sont écoulés dans l'année

JULIAN détermine le nombre de jours qui se sont écoulés jusqu'à la date dans le champ DATE :

JULIAN(DATE)

Les valeurs suivantes sont des exemples pour DATE et les valeurs correspondantes pour JULIAN(DATE) :

DATE         JULIAN(DATE)
----         ------------
01/01/2000   1
02/01/2000   32
03/01/2000   61

Haut de page

x
MONTH : Extraire le composant de mois d'une date

Comment :

La fonction MONTH extrait le mois de la date et renvoie le résultat sous forme d'entier.



x
Syntaxe : Extraire le mois à partir d'une date
MONTH(date);

où :

date
est la date (au format Date) à partir de laquelle extraire le mois, ou un champ contenant la date.


Exemple : Extraire le composant « mois » d'une date

MONTH extrait le mois du mois à partir de chaque valeur d'un champ DATE :

MONTH(DATE)

Les valeurs suivantes sont des exemples pour DATE et les valeurs correspondantes pour MONTH(DATE) :

DATE         MONTH(DATE)
----         -----------
01/01/2000   1
02/01/2000   2
03/01/2000   3

Haut de page

x
QUARTER : Determiner le trimestre

Comment :

La fonction QUARTER détermine le trimestre de l'année durant lequel réside une date, et renvoie le résultat sous forme d'entier.



x
Syntaxe : Déterminer le trimestre pour une date
QUARTER(date);

où :

date
est la date (au format Date) pour laquelle déterminer le trimestre, ou un champ contenant la date.


Exemple : Déterminer le trimestre pour une date

QUARTER extrait le composant Trimestre à partir de chaque valeur d'un champ DATE :

QUARTER(DATE)

Les valeurs suivantes sont des exemples pour DATE et les valeurs correspondantes pour QUARTER(DATE) :

DATE         QUARTER(DATE)
----         -------------
01/01/2000   1
04/01/2000   2
07/01/2000   3

Haut de page

x
SETMDY : Définir la valeur à une date

Comment :

La fonction SETMDY définit une valeur à une date basée sur des valeurs numériques représentant un jour, un mois et une année. SETMDY renvoie 0 si la fonction réussie, et un nombre négatif si la fonction échoue.



x
Syntaxe : Définir une valeur à une date
SETMDY(date, month, day, year);

ou

date.SETMDY(month, day, year);

où :

date
est la date, au format de date, ou un champ contenant la date.
month
est une valeur entière représentant un mois.
day
est une valeur entière représentant le jour du mois.
year
est une valeur entière représentant une année.


Exemple : Définir une valeur à une date

SETMDY définie la valeur de DateVar, qui est formatée comme date qui s'affiche sous forme de wrMtrDYY (par exemple, Samedi, 1er Janvier, 2000) :

SETMDY(DateVar, month, day, year);

Les valeurs suivantes sont des exemples pour Mois, Jour, et Année, et les dates correspondantes pour DateVar :

month  day   year   DateVar
-----  ---   ----   -------
04     05    1965   Monday, April 5, 1965
02     01    1997   Saturday, February 1, 1997
01     01    2000   Saturday, January 1, 2000

Haut de page

x
SUB : Soustraire une valeur à partir d'une date

Comment :

La fonction SUB soustrait un nombre donné de jours d'une date.



x
Syntaxe : Soustraire une valeur à partir d'une date
SUB(date,value)

ou

date.SUB(value)

où :

date
est la date à partir de laquelle soustraire la valeur, ou un champ contenant la date.
value
est la valeur à soustraire à partir de la date.


Exemple : Soustraire les jours à partir d'une date

SUB extrait 10 jours à partir de chaque valeur d'un champ DateVar.

SUB(DateVar, 10)

Les valeurs suivantes sont des exemples pour DateVar et les valeurs correspondantes pour SUB (DateVar, 10) :

DateVar      SUB(DateVar, 10);
-------      -----------------
12/31/1999   12/21/2000
01/01/2000   12/22/2000
01/02/2000   12/23/2000

Haut de page

x
WEEKDAY : Déterminer le jour de la semaine pour une date

Comment :

La fonction WEEKDAY détermine le jour de la semaine pour une date et renvoie le résultat sous forme d'entier (1=lundi, 2=mardi, et ainsi de suite).



x
Syntaxe : Déterminer le jour du mois pour une date
WEEKDAY(date);

où :

date
est la date (au format Date) pour laquelle déterminer le jour de la semaine, ou un champ contenant la date.


Exemple : Déterminer le jour du mois pour une date

WEEKDAY détermine le jour de la semaine pour chaque date dans le champ DATE, et les stocke ce jour-là comme nombre correspondant à un jour de la semaine :

WEEKDAY(DATE)

Les valeurs suivantes sont des exemples pour DATE et les valeurs correspondantes pour WEEKDAY (DATE) :

DATE         WEEKDAY(DATE)
----         -------------
01/01/2000   6
01/02/2000   7
01/03/2000   1

Haut de page

x
YEAR : Extraire l'année à partir d'une date

Comment :

La fonction YEAR extrait l'année d'une date.



x
Syntaxe : Extraire l'année à partir d'une date
YEAR(date);

où :

date
est la chaîne à partir de laquelle extraire l'année, ou un champ contenant la date.


Exemple : Extraire l'année à partir d'une date

YEAR extrait l'année du champ DATE, et stocke cette année dans le champ YEAR(DATE) :

YEAR(DATE)

Les valeurs suivantes sont des exemples pour DATE et les valeurs correspondantes pour YEAR(DATE) :

DATE          YEAR(DATE)
----          ----------
01/01/2000    2000
02/01/2001    2001
03/01/2002    2002

WebFOCUS