SMTP_Date

4D v19

SMTP_Date


SMTP_Date ( smtp_ID ; msgData ; msgHora ; fusoHorario ; offset {; excluirOpcao} ) -> Resultado

Parâmetro	Tipo	Descrição
smtp_ID	Inteiro longo	Referencia da mensagem
msgData	Data	Data de criação da mensagem
msgHora	Hora	Hora de criação da mensagem
fusoHorario	Inteiro	Código de localização
offset	Inteiro	Depende do valor do parâmetro fusoHorario
excluirOpcao	Inteiro	0 = Adicionar/Substituir, 1 = Excluir
Resultado	Inteiro	Código de erro

Descrição

Dada uma data, uma hora, e uma localização geográfica do criador da mensagem, o comando SMTP_Date cria o cabeçalho Date da mensagem especificada por smtp_ID. A data e hora que são passadas ao comando devem corresponder a localização atual da máquina que envia a mensagem. Como os parâmetros a continuação devem respeitar um formato específico, de maneira que o servidor de correio no extremo receptor da mensagem pode interpretar a data e a hora locais segundo a data, a hora, o fuso horário e o offset passados.

Nota: Se uma mensagem de email está composta sem cabeçalho Date, o servidor SMTP adiciona um em função de sua configuração atual de data e hora. Todos as mensagens SMTP contém um cabeçalho Date, seja adicionado pela aplicação cliente ou pelo servidor SMTP

smtp_ID é a referencia inteiro longo de um email criado com o comando SMTP_New.

msgData é uma data 4D que contém a data em que esta mensagem foi criada.

msgHora indica a hora de criação da mensagem.

fusoHorario identifica o fuso horário do remetente. Este campo aceita um valor entre 0 e 6 em função das seguintes indicações.

Um valor de 0 (zero) permite ao usuário especificar diretamente no parâmetro offset o número de horas para sumar ou restar da hora universal.
Um valor de 1 faz que a máquina que envia adicione automaticamente o offset baseada na PRAM do Macintosh. Se o fuso horário é 1 o parâmetro offset não é necessário. O fuso horário de um ordenador Macintosh está determinado pelas preferências do sistema data e hora. Os desenvolvedores devem levar em conta a precisão desta opção se os valores de tempo são um fator crítico para seus bancos de dados.
Os valores de 2 a 5 correspondem aos quatro fusos horários nos Estados Unidos. O offset para cada um destes valores especifica se o fuso horário está em horário de verão (offset = 1) ou não (offset = 0).
Um valor de 6 especifica que a hora é dada em hora militar. Neste caso, o offset está determinado pela tabela horária a continuação. Utilize o valor de offset correspondente (-12 a 12), baseado no código horário em 24 horas da localização do remetente.

O valor do parâmetro offset depende do código definido no parâmetro fusoHorario. Ver as descrições anteriores ou a tabela de abaixo para encontrar o valor correto a passar neste parâmetro.

Código	Fuso Horário	Parâmetro Offset
0	+/- offset UT	Offset em horas +/-
1	+/- offset UT	Offset não utilizado, offset fornecido pela PRAM de Mac
2	EST - EDT	(0 = EST, 1 = EDT)
3	CST - CDT	(0 = CST, 1 = CDT)
4	MST - MDT	(0 = MST, 1 = MDT)
5	PST - PDT	(0 = PST, 1 = PDT)
6	Hora militar	Ver tabela a continuação

Valores de offset	Códigos horários militares
0	Z
-1 a -9	A a I
-10 a -12	K a M
1 a 12	N a Y

Definições das abreviaturas
UT	Hora Universal
EST	Hora Estandarte do Este
EDT	Hora de verão do Este
CST	Hora Central
CDT	Hora de verão Central
MST	Tempo estandarte da Montanha
MDT	Hora de verão das Montanhas
PST	Hora Estandarte do Pacífico
PDT	Hora de verão do Pacífico

excluirOpcao: Um valor de zero será adicionado o cabeçalho Date com os parâmetros dados, ou substitui o anterior. Um valor de 1 elimina todo valor previamente definido neste cabeçalho. Os valores dos outros parâmetros são ignorados. excluirOpcion é um parâmetro opcional que por padrão tem o valor de zero.

Ver também

SMTP_New