4D Doc Center : SMTP

4D Internet Commands v14

SMTP_Date


SMTP_Date ( smtp_ID ; msgFecha ; msgHora ; zonaHoraria ; offset {; eliminarOpcion} ) -> resultado

Parámetro	Tipo	Descripción
smtp_ID	Entero largo	Referencia del mensaje
msgFecha	Fecha	Fecha de creación del mensaje
msgHora	Hora	Hora de creación del mensaje
zonaHoraria	Entero	Código de ubicación
offset	Entero	Depende del valor del parámetro zonaHoraria
eliminarOpcion	Entero	0 = Añadir/Reemplazar, 1 = Borrar
resultado	Entero	Código de error

Descripción

Dada una fecha, una hora, y una ubicación geográfica del creador del mensaje, el comando SMTP_Date crea el encabezado Date del mensaje especificado por smtp_ID. La fecha y hora que se pasan al comando deben corresponder a la ubicación actual de la máquina que envía el mensaje. Como los parámetros a continuación deben respetar un formato específico, de manera que el servidor de correo en el extremo receptor del mensaje puede interpretar la fecha y la hora locales según la fecha, la hora, la zona horaria y el offset pasados.

Nota: si un mensaje de correo electrónico está compuesto sin encabezado Date, el servidor SMTP añade uno en función de su configuración actual de fecha y hora. Todos los mensajes electrónicos SMTP contienen un encabezado Date, ya sea añadido por la aplicación cliente o por el servidor SMTP

smtp_ID es la referencia entero largo de un mensaje electrónico creado con el comando SMTP_New.

msgFecha es una fecha 4D que contiene la fecha en que este mensaje fue creado.

msgHora indica la hora de creación del mensaje.

zonaHoraria identifica la zona horaria del remitente. Este campo acepta un valor entre 0 y 6 en función de las siguientes indicaciones.

Un valor de 0 (cero) permite al usuario especificar directamente en el parámetro offset el número de horas para sumar o restar de la hora universal.
n valor de 1 hace que la máquina que envía añada automáticamente el offset basada en la PRAM del Macintosh. Si la zona horaria es 1 el parámetro offset no es necesario. La zona horaria de un ordenador Macintosh está determinada por las preferencias del sistema fecha y hora. Los desarrolladores deben tener en cuenta la exactitud de esta opción si los valores de tiempo son un factor crítico para sus bases de datos.
Los valores de 2 a 5 corresponden a las cuatro zonas horarias en los Estados Unidos. El offset para cada uno de estos valores especifica si la zona horaria está en horario de verano (offset = 1) o no (offset = 0).
Un valor de 6 especifica que la hora se da en hora militar. En este caso, el offset está determinado por la tabla horaria a continuación. Utilice el valor de offset correspondiente (-12 a 12), basado en el código horario en 24 horas de la localización del remitente.

El valor del parámetro offset depende del código definido en el parámetro zonaHoraria. Ver las descripciones anteriores o la tabla de abajo para encontrar el valor correcto a pasar en este parámetro.

Código	Zona Horaria	Parámetro Offset
0	+/- offset UT	Offset en horas +/-
1	+/- offset UT	Offset no utilizado, offset suministrado por la 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 tabla a continuación

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

Definiciones de las abreviaturas
UT	Hora Universal
EST	Hora Estándar del Este
EDT	Hora de verano del este
CST	Hora Central
CDT	Hora de verano Central
MST	Tiempo estándar de la Montaña
MDT	Hora de verano de las Montañas
PST	Hora Estándar del Pacífico
PDT	Hora de verano del Pacífico

eliminarOpcion: Un valor de cero agregará el encabezado Date con los parámetros dados, o reemplaza el anterior. Un valor de 1 elimina todo valor previamente definido en este encabezado. Los valores de los otros parámetros se ignoran. eliminarOpcion es un parámetro opcional que por defecto tiene el valor cero.