version 6.5
SMTP_Date (smtp_ID; msgDate; msgHeure; fuseauHoraire; décalage{; supprimerOption}) Entier
Paramètre | Type | Description | |
smtp_ID | Entier long | Référence du message | |
msgDate | Date | Date de création du message | |
msgHeure | Heure | Heure de création du message | |
fuseauHoraire | Entier | Code d'emplacement | |
décalage | Entier | Dépend de la valeur du paramètre fuseauHoraire | |
supprimerOption | Entier | 0 = Ajouter/Remplacer, 1 = Effacer | |
Résultat | Entier | Code d'erreur |
Description
La commande SMTP_Date crée l'en-tête Date du message désigné par le paramètre smtp_ID. La date et l'heure fournies à la commande doivent correspondre à l'emplacement courant de la machine envoyant le message. Les paramètres suivants doivent respecter un format spécifique de manière à ce que le serveur de courrier électronique réceptionnant le message puisse déterminer la date et l'heure locales en fonction de la date, l'heure, la zone horaire et le décalage qui lui sont communiqués.
Note : Si un message électronique est composé sans en-tête Date, le serveur SMTP en ajoute une en fonction de ses réglages courants d'heure et de date. Tous les messages électroniques SMTP contiennent un en-tête Date ajouté soit par l'application cliente, soit par le serveur SMTP.
Le paramètre smtp_ID contient l'identifiant du message créé avec la commande SMTP_New.
Le paramètre msgDate est une date 4D qui indique la date de création du message.
Le paramètre msgHeure indique l'heure de création du message.
Le paramètre fuseauHoraire identifie le fuseau horaire de l'émetteur. Vous pouvez passer toute valeur comprise entre 0 et 6, en fonction des indications suivantes :
0 (zéro) permet de spécifier directement dans le paramètre décalage le nombre d'heures à soustraire ou à ajouter au temps universel (TU).
Si vous passez 1, la machine émettrice ajoutera automatiquement le décalage fondé sur la PRAM du Macintosh. Lorsque vous passez 1 dans fuseauHoraire, le paramètre décalage est inutile. Le fuseau horaire d'un ordinateur Macintosh est déterminé par les préférences système Date et heure. Vous devez veiller à l'exactitude de ce paramétrage si les valeurs horaires sont un facteur primordial de votre base de données.
Les valeurs de 2 à 5 correspondent aux 4 fuseaux horaires des Etats-Unis. Le décalage pour chacune de ces valeurs spécifie si cette zone horaire est en heure d'été (décalage = 1) ou non (décalage = 0).
Si vous passez 6, vous indiquez que le temps est défini sur 24 heures. Dans ce cas, le décalage est déterminé par le tableau horaire ci-dessous. Passez la valeur de décalage correspondante (de -12 à 12) au code horaire sur 24 heures de l'emplacement de l'émetteur.
La valeur du paramètre décalage dépend du code défini dans le paramètre fuseauHoraire. Reportez-vous aux descriptions et au tableau horaire suivants pour connaître la valeur correcte à passer dans ce paramètre.
Code | Fuseau horaire | Paramètre de décalage |
0 | +/- décalage TU | Le décalage est en heures +/- |
1 | +/- décalage TU | Le décalage n'est pas utilisé, il est fourni par la PRAM du Mac |
2 | HNE - HAE | ( 0 = HNE, 1 = HAE ) |
3 | HNC - HAC | ( 0 = HNC, 1 = HAC ) |
4 | HNR - HAR | ( 0 = HNR, 1 = HAR ) |
5 | HNP - HAP | ( 0 = HNP, 1 = HAP ) |
6 | Heure sur 24 heures | Voir tableau ci-dessous |
Valeurs de décalage | Codes horaires sur 24 heures |
0 | Z |
-1 à -9 | A à I |
-10 à -12 | K à M |
1 à 12 | N à Y |
Définitions des abréviations
TU | Temps Universel |
HNE | Heure normale de l'Est |
HAE | Heure avancée de l'Est |
HNC | Heure normale du Centre |
HAC | Heure avancée du Centre |
HNR | Heure normale des Rocheuses |
HAR | Heure avancée des Rocheuses |
HNP | Heure normale du Pacifique |
HAP | Heure avancée du Pacifique |
supprimerOption :
Passez 0 (zéro) dans ce paramètre pour ajouter un nouvel en-tête Date ou remplacer le précédent.
Passez 1 pour effacer toute valeur préalablement définie dans cet en-tête.
Si vous omettez ce paramère, la valeur 0 est utilisée.
Référence