Cette section décrit la commande uxdat utilisée pour modifier le format d'une date, réaliser un décalage en jour et obtenir le type ou le rang d'un jour dans le calendrier.
Les sept résultats sont fournis à l'écran (sous UNIX et Windows) ou sous la forme de symboles (sous OpenVMS). Seul, l'un des 7 résultats est renseigné selon le type demandé. Le résultat est en minuscules si le format l'est, il est en majuscules si au moins un caractère du format de sortie spécifié est saisi en majuscules.
La langue par défaut est internationale (Anglais). Le choix de la langue du format est déterminé par le format lui même: j, a, s, ... pour Français et d, y, w, ... pour International. La plus petite unité de temps traitée est le jour et la plus grande est l'année.
Syntaxe
Seule la cohérence syntaxique est vérifiée.
Deux syntaxes sont possibles selon le résultat que l'on veut obtenir.
Formatages et décalages
Les décalages sont traités séquentiellement de gauche à droite.
La syntaxe de cette commande est la suivante :
uxdat "Format date source" "Date source" "Format date cible" "Décalage"
Exemple :
uxdat "jj/mm/aaaa" "01/01/2018" "jj-mmm-aa" "-1jo/1m"
Sortie :
Résultat 1 : U_DATE_RES : Date au format cible avec le décalage demandé.
Type de jour
La syntaxe de cette commande est la suivante :
uxdat "Format date source" "Date source" "type" [MU=<nom de l'UG>]
Exemple :
uxdat "jj/mm/aaaa" "01/01/2018" "odm"
Sortie : le résultat ou symboles globaux (OpenVMS) dépend de la valeur prise par "type". uxdat valorise les symboles globaux suivants en fonction des arguments.
Résultat 2 : U_TYPE_JOUR : Statut de la date source (Ouvré, Chômé, Férié).
Résultat 3 : U_RGO_DEB_MOIS : Rang d'un jour ouvré dans le mois (à partir du début).
Résultat 4 : U_RGO_FIN_MOIS : Rang d'un jour ouvré dans le mois (à partir de la fin).
Résultat 5 : U_RGO_DEB_ANNEE : Rang d'un jour ouvré dans l'année (à partir du début).
Résultat 6 : U_RGO_FIN_ANNEE : Rang d'un jour ouvré dans l'année (à partir de la fin).
Résultat 7 : U_NBJOURS: Nombre de jours entre deux dates.
Description des items
Format date source et Format date cible
Le format des dates doit utiliser les codes suivants :
|
Format des dates |
Français |
International |
|---|---|---|
|
Mois sous la forme 1-12 |
m |
m |
|
Mois sous la forme 01-12 |
mm |
mm |
|
Mois sous la forme de jan à déc (jan to dec) |
mmm |
mmm |
|
Mois sous la forme de janvier à décembre (january to december) |
mmmm |
mmmm |
|
Jours sous la forme 1-31 |
j |
d |
|
Jours sous la forme 01-31 |
jj |
dd |
|
Jours sous la forme 1 à 7 |
p |
p |
|
Jours sous la forme lun à dim (mon to sun) |
jjj |
ddd |
|
Jours sous la forme lundi à dimanche (monday to sunday) |
jjjj |
dddd |
|
Semaine sous la forme 1-52 |
s |
w |
|
Semaine sous la forme 01-52 |
ss |
ww |
|
Quantième sous la forme 1-365 |
q |
q |
|
Quantième sous la forme 001-365 |
qqq |
qqq |
|
Années sous la forme 00 à 99 |
aa |
yy |
|
Années sous la forme 0000 à 9999 |
aaaa |
yyyy |
Lorsque le format d'entrée comporte une année sur 2 caractères, l'année est interprétée comme suit :
Date source
La date source doit être saisie au format indiqué par le Format date source. La commande uxdat n'accepte que des dates comprises entre 1970 et 2040.
Décalage
Le décalage doit utiliser les codes suivants ("n" est un nombre entier) :
|
Décalages |
Français |
International |
|---|---|---|
|
Séparateur |
/ |
/ |
|
Position |
n |
n |
|
Décalage négatif |
-n |
-n |
|
Décalage positif |
+n |
+n |
|
Décalage positif de n jour calendaire |
+nj |
+nd |
|
Décalage négatif de n jour calendaire |
-nj |
-nd |
|
Décalage positif de n jour ouvré |
+njo |
+ndo |
|
Décalage négatif de n jour ouvré |
-njo |
-ndo |
|
Position au nième jour calendaire de la semaine |
ns |
nw |
|
Position au nième jour ouvré de la semaine |
nso |
nwo |
|
Décalage positif de n semaine |
+ns |
+nw |
|
Décalage négatif de n semaine |
-ns |
-nw |
|
Position au nième jour calendaire du mois |
nm |
nm |
|
Position au nième jour ouvré du mois |
nmo |
nmo |
|
Position au nième jour (type p) calendaire du mois |
nmp |
nmp |
|
Position au nième jour (type p) ouvré du mois |
nmop |
nmop |
|
Décalage positif de n mois |
+nm |
+nm |
|
Décalage négatif de n mois |
-nm |
-nm |
|
Position au nième jour calendaire de l'année |
na |
ny |
|
Position au nième jour ouvré de l'année |
nao |
nyo |
|
Position au nième jour (type p) de l'année |
nap |
nyp |
|
Position au nième jour (type p) ouvré de l'année |
naop |
nyop |
|
Position au nième mois de l'année |
nma |
nmy |
|
Décalage positif de n année |
+na |
+ny |
|
Décalage négatif de n année |
-na |
-ny |
Type
Le type doit utiliser les codes suivants :
|
Type |
Français |
International |
|---|---|---|
|
Rang d'un jour ouvré dans le mois (début) |
odm |
obm |
|
Rang d'un jour ouvré dans le mois (fin) |
ofm |
oem |
|
Rang d'un jour ouvré dans l'année (début) |
oda |
oby |
|
Rang d'un jour ouvré dans l'année (fin) |
ofa |
oey |
MU=
(Optionnel) Saisissez le nom de l'unité de gestion du calendrier ciblé. Les accès aux calendriers de Dollar Universe ne se font que lors des décalages en jours ouvrés et des demandes de "Statut de la date source". Toutes les autres opérations sont indépendantes de l'environnement de Dollar Universe.
Exemples
Exemples de format pour le 01/02/1999 :
|
"j" |
1 |
|
"jj" |
01 |
|
"jjj" |
lun |
|
"jjjj" |
lundi |
|
"jjjj jj mmmm aaaa" |
lundi 01 février 1999 |
|
"dd mmmm yyyy" |
01 february 1999 |
|
"q" |
32 (quantième : position dans l'année) |
|
"qqq" |
032 (quantième : position dans l'année) |
|
"s" |
5 (semaine) |
|
"ss" |
05 (semaine) |
|
"jj-mmm-aaaa" |
01-fev-1999 |
|
"dd-mmm-yyyy" |
01-feb-1999 |
Exemples de décalage pour le 01/02/1999 :
|
"+1m/1m/-1jo" |
dernier jour ouvré du mois (décalage +1 mois, 1er jour du mois, décalage -1 jour ouvré) |
|
"+1a/1a/-1s/7s" |
dernier dimanche de l'année (décalage +1 an, 1er jour de l'année, décalage -1 semaine, 7ème jour) |