4D Doc Center : SMTP

4D Internet Commands v14

SMTP_Date


SMTP_Date ( smtp_ID ; msgDate ; msgHeure ; fuseauHoraire ; décalage {; supprimerOption} ) -> Résultat

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.