Saltar al contenido

Funciones de fecha y hora en Jitterbit Integration Studio

Introducción

Si está utilizando estas funciones junto con el Now o Now_ funciones, tenga en cuenta que la huso horario devuelta es la configurada en la máquina que ejecuta el agente. Todos los agentes de la nube están en UTC. Los agentes privados variarán según la máquina específica en la que se ejecuta cada agente. Si está utilizando una función de conversión, tenga esto en cuenta si su proyecto está diseñado para ejecutarse tanto en la nube como en un agente privado.

Nota

Si tiene la configuración Anular Huso horario del Agente de programación habilitada en las políticas de su organización, cualquier secuencias de comandos que utilice funciones de fecha y hora como las descritas aquí no será reemplazado por la huso horario seleccionada.

Códigos de zona horaria

Los parámetros de huso horario son uno de los códigos de huso horario estándar, ya sea un nombre completo (código TZ) como "America/Los_Angeles", un desfase UTC como "UTC-8:00", o una abreviatura como "PST" (código de tres letras). Los códigos de zona horaria distinguen entre mayúsculas y minúsculas. Se recomienda utilizar códigos TZ con el nombre completo si se utiliza una huso horario, ya que "AST" puede hacer referencia a la hora estándar del "Atlántico" o "árabe".

Convertir horas Unix a fechas

Si una hora Unix es un número que incluye una precisión de milisegundos, puede utilizar un código similar a este para convertir una hora Unix en una fecha:

// If you have a Unix timestamp with milliseconds such as
createdate = "1478119530707";
// You can convert it to a date by
// truncating the last three digits and using FormatDate:
date = double(Left(createdate, 10));
FormatDate(date, "yyyy-mm-dd");

ConvertTimeZone

Declaración

string ConvertTimeZone(date d, string fromTZ, string toTZ[, bool is_european_format, bool ignoreDST])

string ConvertTimeZone(string d, string fromTZ, string toTZ[, bool is_european_format, bool ignoreDST])

Sintaxis

ConvertTimeZone(<d>, <fromTZ>, <toTZ>[, <is_european_format>, <ignoreDST>])

Parámetros necesarios

  • date: Una fecha, ya sea como un objeto de fecha o como una cadena de fecha
  • fromTZ: La huso horario desde la que se convertirá, expresada como un código de huso horario
  • toTZ: La huso horario a la que se convertirá, expresada como un código de huso horario

Parámetros opcionales

  • is_european_format: Esta bandera opcional determina si se utilizará el formato de fecha europeo. Cuando true, el formato es día y luego mes; cuando false El formato es mes y luego día.

  • ignoreDST: De manera predeterminada, el horario de verano se tiene en cuenta al realizar la conversión entre las cuatro husos horarios principales de EE. UU. Establezca esta bandera opcional en true para anular esta acción.

Descripción

Toma una fecha y la devuelve convertida de una huso horario a otra.

Nota

Si está utilizando ConvertTimeZone en conjunto con Now o Now_ Tenga en cuenta que la huso horario devuelta es la configurada en la máquina en la que se ejecuta el agente. Todos los agentes de la nube están en UTC. Los agentes privados variarán según la máquina específica en la que se ejecute cada agente. Si está utilizando una función de conversión, como ConvertTimeZone Tenga esto en cuenta si su proyecto está diseñado para ejecutarse tanto en la nube como en un agente privado.

Ejemplos

ConvertTimeZone(Now(), "UTC", "America/Los_Angeles", false, false);
// If Now() is 2017-03-10 18:34:37
// returns "2017-03-10 10:34:37"

ConvertTimeZone("02/06/2017 5:25:00", "America/Los_Angeles", "America/New_York");
// returns "2017-02-06 08:25:00" (shifts the time by 3 hours)